Armazenar e aceder a ficheiros no SharePoint Embedded com as APIs REST do Microsoft Graph

  • 6 minutos

Os programadores que criam aplicações que utilizam o SharePoint Embedded utilizarão APIs do Microsoft Graph bem conhecidas e estabelecidas para aceder aos ficheiros e documentos nestes Contentores. O ponto final da Unidade do Microsoft Graph pode aceder aos dados armazenados num Contentor Do SharePoint Embedded. Nesta secção, irá aprender a utilizar as APIs REST do Microsoft Graph para armazenar e obter ficheiros e documentos em Contentores Do SharePoint Embedded.

Importante

Neste momento, muitos dos pontos finais do Microsoft Graph utilizados para criar, aceder e gerir recursos específicos do SharePoint Embedded só existem no ponto final beta do Microsoft Graph. No entanto, todos os pontos finais que acedem aos Contentores e conteúdos contidos estão no ponto final do Microsoft Graph v1.0.

Trabalhar com Contentores

Depois de concluir todos os processos de configuração e registo entre o fornecedor e os inquilinos que consomem, tem de criar um Contentor no inquilino que está a consumir.

Criar um novo Contentor

Para criar um Contentor, submeta um HTTP POST com um payload JSON que especifique o nome, a descrição e o ID do ContainerType associado:

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

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

O Microsoft Graph responderá com os detalhes do novo Contentor:

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

Listar todos os Contentores

Para obter uma lista de todos os Contentores criados, submeta um pedido HTTP GET e filtre pelo ID containerType:

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

Obter um Contentor específico

Para obter um Contentor específico, submeta um pedido HTTP GET para o Containers ponto final:

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

Trabalhar com o conteúdo de um Contentor

Para trabalhar com os conteúdos ou ficheiros num Contentor, irá utilizar os mesmos pontos finais do Microsoft Graph disponíveis para ler e escrever em bibliotecas de documentos do SharePoint ou no OneDrive: o drives ponto final. Isto acontece porque um Contentor Do SharePoint Embedded é visto como a mesma coisa que um objeto do Microsoft Graph Drive e os ficheiros dentro do Drive são DriveItems.

Obter um Contentor específico como um Drive objeto

Para obter um contentor específico como um objeto de Unidade, submeta um pedido HTTP GET para o ponto final do Microsoft Graph drives :

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

Para saber mais sobre o ponto final do Microsoft Graph drives , veja Microsoft Graph REST API: Get Drive (API REST do Microsoft Graph: Obter Unidade).

Listar o conteúdo de um Contentor

Para obter o conteúdo de um Contentor, submeta um pedido HTTP GET para o mesmo ponto final, mas aceda aos subordinados do Contentor:

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

Carregar um ficheiro para um Contentor

Para carregar um ficheiro para um Contentor, submeta um pedido HTTP POST para o drives ponto final e inclua o conteúdo do ficheiro no pedido:

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

<binary contents of the file>

Eliminar o conteúdo de um Contentor

Para eliminar um ficheiro de um Contentor, submeta um pedido HTTP DELETE para o drives ponto final:

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

Para saber mais sobre como trabalhar com ficheiros com o Microsoft Graph, veja Microsoft Graph REST API: Drive Items (API REST do Microsoft Graph: Itens de Unidade).

Resumo

Os programadores que criam aplicações que utilizam o SharePoint Embedded utilizarão APIs do Microsoft Graph bem conhecidas e estabelecidas para aceder aos ficheiros e documentos nestes Contentores. O ponto final da Unidade do Microsoft Graph pode aceder aos dados armazenados num Contentor Do SharePoint Embedded.

Nesta secção, aprendeu a utilizar as APIs REST do Microsoft Graph para armazenar e obter ficheiros e documentos em Contentores Do SharePoint Embedded.