Speichern und Zugreifen auf Dateien in SharePoint Embedded mit Microsoft Graph-REST-APIs

6 Minuten

Entwickler, die Apps erstellen, die SharePoint Embedded verwenden, verwenden bekannte und etablierte Microsoft Graph-APIs, um auf die Dateien und Dokumente in diesen Containern zuzugreifen. Der Microsoft Graph Drive-Endpunkt kann auf Daten zugreifen, die in einem SharePoint Embedded-Container gespeichert sind. In diesem Abschnitt erfahren Sie, wie Sie die Microsoft Graph-REST-APIs verwenden, um Dateien und Dokumente in SharePoint Embedded-Containern zu speichern und abzurufen.

Wichtig

Derzeit sind viele der Microsoft Graph-Endpunkte, die zum Erstellen, Zugreifen und Verwalten von SharePoint Embedded-spezifischen Ressourcen verwendet werden, nur auf dem Betaendpunkt von Microsoft Graph vorhanden. Alle Endpunkte, die auf die Container und Inhalte in contains zugreifen, befinden sich jedoch auf dem Microsoft Graph v1.0-Endpunkt.

Arbeiten mit Containern

Nachdem Sie alle Setup- und Registrierungsprozesse zwischen dem Anbieter und den nutzenden Mandanten abgeschlossen haben, müssen Sie einen Container im nutzenden Mandanten erstellen.

Erstellen eines neuen Containers

Um einen Container zu erstellen, übermitteln Sie einen HTTP POST mit einer JSON-Nutzlast, die den Namen, die Beschreibung und die zugeordnete ContainerType-ID angibt:

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

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

Microsoft Graph antwortet mit den Details des neuen Containers:

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

Auflisten aller Container

Um eine Liste aller erstellten Container abzurufen, senden Sie eine HTTP GET-Anforderung, und filtern Sie nach der ContainerType-ID:

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

Abrufen eines bestimmten Containers

Um einen bestimmten Container abzurufen, übermitteln Sie eine HTTP GET-Anforderung an den Containers Endpunkt:

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

Arbeiten mit dem Inhalt eines Containers

Um mit den Inhalten oder Dateien in einem Container zu arbeiten, verwenden Sie dieselben Microsoft Graph-Endpunkte, die zum Lesen und Schreiben in SharePoint-Dokumentbibliotheken oder OneDrive verfügbar sind: den drives Endpunkt. Dies liegt daran, dass ein SharePoint Embedded-Container als dasselbe wie ein Microsoft Graph-Objekt Drive angesehen wird, und Dateien innerhalb von Drive sind DriveItems.

Abrufen eines bestimmten Containers als `Drive` Objekt

Um einen bestimmten Container als Drive-Objekt abzurufen, übermitteln Sie eine HTTP GET-Anforderung an den Microsoft Graph-Endpunkt drives :

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

Weitere Informationen zum Microsoft Graph-Endpunkt drives finden Sie unter Microsoft Graph-REST-API: Laufwerk abrufen.

Auflisten des Inhalts eines Containers

Um den Inhalt eines Containers abzurufen, senden Sie eine HTTP GET-Anforderung an denselben Endpunkt, wechseln Sie jedoch zu den untergeordneten Elementen des Containers:

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

Hochladen einer Datei in einen Container

Um eine Datei in einen Container hochzuladen, übermitteln Sie eine HTTP POST-Anforderung an den drives Endpunkt, und fügen Sie den Inhalt der Datei in die Anforderung ein:

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

<binary contents of the file>

Löschen des Inhalts eines Containers

Um eine Datei aus einem Container zu löschen, übermitteln Sie eine HTTP DELETE-Anforderung an den drives Endpunkt:

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

Weitere Informationen zum Arbeiten mit Dateien mit Microsoft Graph finden Sie unter Microsoft Graph-REST-API: Laufwerkselemente.

Zusammenfassung

In diesem Abschnitt haben Sie erfahren, wie Sie die Microsoft Graph-REST-APIs verwenden, um Dateien und Dokumente in SharePoint Embedded-Containern zu speichern und abzurufen.