Stocker et accéder à des fichiers dans SharePoint Embedded avec les API REST Microsoft Graph

  • 6 minutes

Les développeurs qui créent des applications qui utilisent SharePoint Embedded utilisent des API Microsoft Graph connues et établies pour accéder aux fichiers et documents de ces conteneurs. Le point de terminaison Du lecteur Microsoft Graph peut accéder aux données stockées dans un conteneur SharePoint Embedded. Dans cette section, vous allez apprendre à utiliser les API REST Microsoft Graph pour stocker et récupérer des fichiers et des documents dans des conteneurs SharePoint Embedded.

Importante

À l’heure actuelle, la plupart des points de terminaison Microsoft Graph utilisés pour créer, accéder et gérer des ressources spécifiques à SharePoint Embedded existent uniquement sur le point de terminaison bêta de Microsoft Graph. Toutefois, tous les points de terminaison qui accèdent aux conteneurs et au contenu dans contient se trouvent sur le point de terminaison Microsoft Graph v1.0.

Utilisation de conteneurs

Une fois que vous avez terminé tous les processus d’installation et d’inscription entre le fournisseur et les locataires consommateurs, vous devez créer un conteneur dans le locataire consommateur.

Créer un conteneur

Pour créer un conteneur, envoyez une requête HTTP POST avec une charge utile JSON qui spécifie le nom, la description et l’ID ContainerType associé :

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

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

Microsoft Graph répondra avec les détails du nouveau conteneur :

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

Répertorier tous les conteneurs

Pour obtenir la liste de tous les conteneurs créés, envoyez une requête HTTP GET et filtrez en fonction de l’ID ContainerType :

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

Obtenir un conteneur spécifique

Pour obtenir un conteneur spécifique, envoyez une requête HTTP GET au point de Containers terminaison :

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

Utilisation du contenu d’un conteneur

Pour utiliser le contenu ou les fichiers d’un conteneur, vous allez utiliser les mêmes points de terminaison Microsoft Graph disponibles pour la lecture et l’écriture dans les bibliothèques de documents SharePoint ou OneDrive : le point de drives terminaison. Cela est dû au fait qu’un conteneur Incorporé SharePoint est considéré comme la même chose qu’un objet Microsoft Graph Drive et que les fichiers dans le Drive sont DriveItems.

Obtenir un conteneur spécifique en tant qu’objet Drive

Pour obtenir un conteneur spécifique en tant qu’objet Drive, envoyez une requête HTTP GET au point de terminaison Microsoft Graph drives :

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

Pour en savoir plus sur le point de terminaison Microsoft Graph drives , consultez API REST Microsoft Graph : Obtenir un lecteur.

Répertorier le contenu d’un conteneur

Pour obtenir le contenu d’un conteneur, envoyez une requête HTTP GET au même point de terminaison, mais accédez aux enfants du conteneur :

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

Charger un fichier dans un conteneur

Pour charger un fichier dans un conteneur, envoyez une requête HTTP POST au drives point de terminaison et incluez le contenu du fichier dans la requête :

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

<binary contents of the file>

Supprimer le contenu d’un conteneur

Pour supprimer un fichier d’un conteneur, envoyez une requête HTTP DELETE au point de drives terminaison :

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

Pour en savoir plus sur l’utilisation de fichiers à l’aide de Microsoft Graph, consultez API REST Microsoft Graph : Éléments de lecteur.

Résumé

Les développeurs qui créent des applications qui utilisent SharePoint Embedded utilisent des API Microsoft Graph connues et établies pour accéder aux fichiers et documents de ces conteneurs. Le point de terminaison Du lecteur Microsoft Graph peut accéder aux données stockées dans un conteneur SharePoint Embedded.

Dans cette section, vous avez appris à utiliser les API REST Microsoft Graph pour stocker et récupérer des fichiers et des documents dans des conteneurs SharePoint Embedded.