Archiviare e accedere ai file in SharePoint Embedded con le API REST di Microsoft Graph

Completato

Gli sviluppatori che creano app che usano SharePoint Embedded useranno API Microsoft Graph note e consolidate per accedere ai file e ai documenti in questi contenitori. L'endpoint di Microsoft Graph Drive può accedere ai dati archiviati in un contenitore incorporato di SharePoint. In questa sezione si apprenderà come usare le API REST di Microsoft Graph per archiviare e recuperare file e documenti in contenitori incorporati di SharePoint.

Importante

In questo momento, molti degli endpoint di Microsoft Graph usati per creare, accedere e gestire risorse specifiche di SharePoint Embedded esistono solo nell'endpoint beta di Microsoft Graph. Tuttavia, tutti gli endpoint che accedono ai contenitori e al contenuto all'interno di contiene si trovano nell'endpoint di Microsoft Graph v1.0.

Uso dei contenitori

Dopo aver completato tutti i processi di configurazione e registrazione tra il provider e i tenant consumer, è necessario creare un contenitore nel tenant di utilizzo.

Creare un nuovo contenitore

Per creare un contenitore, inviare un POST HTTP con un payload JSON che specifica il nome, la descrizione e l'ID ContainerType associato:

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

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

Microsoft Graph risponderà con i dettagli del nuovo contenitore:

{
  "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"
}

Elencare tutti i contenitori

Per ottenere un elenco di tutti i contenitori creati, inviare una richiesta HTTP GET e filtrare in base all'ID ContainerType:

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

Ottenere un contenitore specifico

Per ottenere un contenitore specifico, inviare una richiesta HTTP GET all'endpoint Containers :

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

Uso del contenuto di un contenitore

Per usare il contenuto o i file in un contenitore, si useranno gli stessi endpoint di Microsoft Graph disponibili per la lettura e la scrittura in raccolte documenti di SharePoint o OneDrive: l'endpoint drives . Questo perché un contenitore incorporato di SharePoint è considerato come la stessa cosa di un oggetto Microsoft Graph Drive e i Drive file all'interno di sono DriveItems.

Ottenere un contenitore specifico come Drive oggetto

Per ottenere un contenitore specifico come oggetto Drive, inviare una richiesta HTTP GET all'endpoint di Microsoft Graph drives :

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

Per altre informazioni sull'endpoint di Microsoft Graph drives , vedere API REST di Microsoft Graph: Ottenere l'unità.

Elencare il contenuto di un contenitore

Per ottenere il contenuto di un contenitore, inviare una richiesta HTTP GET allo stesso endpoint, ma passare agli elementi figlio del contenitore:

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

Caricare un file in un contenitore

Per caricare un file in un contenitore, inviare una richiesta HTTP POST all'endpoint drives e includere il contenuto del file nella richiesta:

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

<binary contents of the file>

Eliminare il contenuto di un contenitore

Per eliminare un file da un contenitore, inviare una richiesta HTTP DELETE all'endpoint drives :

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

Per altre informazioni sull'uso dei file con Microsoft Graph, vedere API REST di Microsoft Graph: Elementi unità.

Riepilogo

Gli sviluppatori che creano app che usano SharePoint Embedded useranno API Microsoft Graph note e consolidate per accedere ai file e ai documenti in questi contenitori. L'endpoint di Microsoft Graph Drive può accedere ai dati archiviati in un contenitore incorporato di SharePoint.

In questa sezione si è appreso come usare le API REST di Microsoft Graph per archiviare e recuperare file e documenti in contenitori incorporati di SharePoint.