前へ

次へ

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

完了

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

重要

現時点では、SharePoint Embedded 固有のリソースの作成、アクセス、管理に使用される Microsoft Graph エンドポイントの多くは、Microsoft Graph ベータ エンドポイントにのみ存在します。 ただし、コンテナーと内のコンテンツにアクセスするすべてのエンドポイントには、Microsoft Graph v1.0 エンドポイントが含まれています。

コンテナーの操作

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

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

コンテナーを作成するには、名前、説明、および関連する 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}}

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

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

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 埋め込みコンテナーが Microsoft Graph Drive オブジェクトと同じと見なされ、 内の Drive ファイルが であるためです DriveItems。

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

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

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

Microsoft Graph エンドポイントの詳細については、「Microsoft Graph drivesREST 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>

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

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

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 にファイルとドキュメントを格納および取得する方法について説明しました。

続行