Almacenamiento y acceso a archivos en SharePoint Embedded con las API REST de Microsoft Graph

6 minutos

Los desarrolladores que creen aplicaciones que usen SharePoint Embedded usarán las API de Microsoft Graph conocidas y establecidas para acceder a los archivos y documentos de estos contenedores. El punto de conexión de Microsoft Graph Drive puede acceder a los datos almacenados en un contenedor de SharePoint Embedded. En esta sección, aprenderá a usar las API REST de Microsoft Graph para almacenar y recuperar archivos y documentos en contenedores incrustados de SharePoint.

Importante

En este momento, muchos de los puntos de conexión de Microsoft Graph usados para crear, acceder y administrar recursos específicos de SharePoint Embedded solo existen en el punto de conexión beta de Microsoft Graph. Sin embargo, todos los puntos de conexión que tienen acceso a los contenedores y el contenido de contiene se encuentran en el punto de conexión de Microsoft Graph v1.0.

Trabajar con contenedores

Una vez que haya completado todos los procesos de instalación y registro entre el proveedor y los inquilinos de consumo, debe crear un contenedor en el inquilino de consumo.

Creación de un nuevo contenedor

Para crear un contenedor, envíe un HTTP POST con una carga JSON que especifique el nombre, la descripción y el identificador containerType asociado:

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

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

Microsoft Graph responderá con los detalles del nuevo contenedor:

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

Enumerar todos los contenedores

Para obtener una lista de todos los contenedores creados, envíe una solicitud HTTP GET y filtre por el identificador ContainerType:

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

Obtención de un contenedor específico

Para obtener un contenedor específico, envíe una solicitud HTTP GET al punto de Containers conexión:

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

Trabajar con el contenido de un contenedor

Para trabajar con el contenido o los archivos de un contenedor, usará los mismos puntos de conexión de Microsoft Graph disponibles para leer y escribir en bibliotecas de documentos de SharePoint o OneDrive: el drives punto de conexión. Esto se debe a que un contenedor incrustado de SharePoint se ve como lo mismo que un objeto de Microsoft Graph Drive y los archivos dentro de Drive son DriveItems.

Obtención de un contenedor específico como un `Drive` objeto

Para obtener un contenedor específico como un objeto Drive, envíe una solicitud HTTP GET al punto de conexión de Microsoft Graph drives :

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

Para obtener más información sobre el punto de conexión de Microsoft Graph drives , consulte API REST de Microsoft Graph: Obtener unidad.

Enumerar el contenido de un contenedor

Para obtener el contenido de un contenedor, envíe una solicitud HTTP GET al mismo punto de conexión, pero vaya a los elementos secundarios del contenedor:

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

Carga de un archivo en un contenedor

Para cargar un archivo en un contenedor, envíe una solicitud HTTP POST al drives punto de conexión e incluya el contenido del archivo en la solicitud:

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

<binary contents of the file>

Eliminación del contenido de un contenedor

Para eliminar un archivo de un contenedor, envíe una solicitud HTTP DELETE al punto de drives conexión:

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

Para obtener más información sobre cómo trabajar con archivos con Microsoft Graph, consulte API REST de Microsoft Graph: Elementos de unidad.

Resumen

En esta sección, ha aprendido a usar las API REST de Microsoft Graph para almacenar y recuperar archivos y documentos en contenedores incrustados de SharePoint.