Microsoft Graph REST API を使用して SharePoint Embedded にファイルを格納およびアクセスする

SharePoint Embedded を使用するアプリを作成する開発者は、既知および確立された Microsoft Graph API を使用して、これらのコンテナー内のファイルとドキュメントにアクセスします。 Microsoft Graph Drive エンドポイントは、SharePoint Embedded Container 内に格納されているデータにアクセスできます。 このセクションでは、Microsoft Graph REST API を使用して SharePoint 埋め込みコンテナーにファイルとドキュメントを格納および取得する方法について説明します。

コンテナーの操作

プロバイダーと使用しているテナントの間のすべてのセットアップと登録プロセスを完了したら、使用しているテナントにコンテナーを作成する必要があります。

新しいコンテナーを作成する

コンテナーを作成するには、名前、説明、および関連する ContainerType ID を指定する JSON ペイロードを含む HTTP POST を送信します。

POST https://graph.microsoft.com/beta/storage/fileStorage/containers

{
  "displayName": "Sample App Container 1",
  "description": "First container description.",
  "containerTypeId": "{{ContainerTypeId}}"
}

Microsoft Graph は、新しいコンテナーの詳細で応答します。

{
  "id": "b!qEMTpi-XGEKZ1W...",
  "displayName": "Sample App Container 1",
  "description": "First container description.",
  "containerTypeId": "3a6b1fc4-0b09-04b3-3a2a-4843fbb60914",
  "status": "inactive",
  "createDateTime": 2023-11-T00:15:25.84Z"
}

すべてのコンテナーを一覧表示する

作成されたすべてのコンテナーの一覧を取得するには、HTTP GET 要求を送信し、ContainerType ID でフィルター処理します。

GET https://graph.microsoft.com/beta/storage/fileStorage/containers?$filter=containerTypeId eq {{ContainerTypeId}}

特定のコンテナーを取得する

特定のコンテナーを取得するには、 Containers エンドポイントに HTTP GET 要求を送信します。

GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{{ContainerID}}?$select=id,displayName,containerTypeId,status,description,customProperties&$expand=permissions

コンテナーの内容の操作

コンテナー内のコンテンツまたはファイルを操作するには、SharePoint ドキュメント ライブラリまたは OneDrive の読み取りと書き込みに使用できるのと同じ Microsoft Graph エンドポイント ( drives エンドポイント) を使用します。 これは、SharePoint Embedded Container が Microsoft Graph Drive オブジェクトと同じものであり、 Drive 内のファイルが DriveItemsされるためです。

特定のコンテナーを Drive オブジェクトとして取得する

特定のコンテナーをドライブ オブジェクトとして取得するには、MICROSOFT Graph drives エンドポイントに HTTP GET 要求を送信します。

GET https://graph.microsoft.com/v1.0/drives/{{ContainerID}}

Microsoft Graph drives エンドポイントの詳細については、「 Microsoft Graph REST API: ドライブの取得」を参照してください。

コンテナーの内容を一覧表示する

コンテナーの内容を取得するには、同じエンドポイントに HTTP GET 要求を送信しますが、コンテナーの子に移動します。

GET https://graph.microsoft.com/v1.0/drives/{{ContainerID}}/items/root/children

コンテナーにファイルをアップロードする

コンテナーにファイルをアップロードするには、HTTP POST 要求を drives エンドポイントに送信し、要求にファイルの内容を含めます。

PUT https://graph.microsoft.com/v1.0/drives/{{ContainerId}}/root:/Jan2024.docx:/content

<binary contents of the file>

コンテナーの内容を削除する

コンテナーからファイルを削除するには、 drives エンドポイントに HTTP DELETE 要求を送信します。

DELETE https://graph.microsoft.com/v1.0/drives/{{ContainerID}}/items/root/{{driveItemID}}

Microsoft Graph を使用したファイルの操作の詳細については、「 Microsoft Graph REST API: ドライブ項目」を参照してください。

概要

SharePoint Embedded を使用するアプリを作成する開発者は、既知および確立された Microsoft Graph API を使用して、これらのコンテナー内のファイルとドキュメントにアクセスします。 Microsoft Graph Drive エンドポイントは、SharePoint Embedded Container 内に格納されているデータにアクセスできます。

このセクションでは、Microsoft Graph REST API を使用して SharePoint Embedded Containers にファイルとドキュメントを格納および取得する方法について説明しました。