Listar as unidades disponíveis

Artigo
04/08/2023

Recupera a lista de recursos Drive disponíveis para um User, Group ou Site de destino.

Permissões

Uma das permissões a seguir é necessária para chamar essa API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Aplicativo	Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Lista as unidades de um grupo

Para listar as bibliotecas de documentos de um grupo, seu aplicativo solicita a relação de unidades no Grupo.

Solicitação HTTP

GET /groups/{groupId}/drives

Lista as unidades do site

Para listar as bibliotecas de documentos de um site, seu aplicativo solicita a relação de unidades no Site.

GET /sites/{siteId}/drives

Lista as unidades de um usuário

GET /users/{userId}/drives

Lista as unidades do usuário atual

GET /me/drives

Parâmetros de consulta opcionais

Esse método dá suporte aos $expandparâmetros de consulta , $select, $skipToken, $tope $orderbyOData para personalizar a resposta.

Resposta

Se bem sucedido, este método retorna um código de resposta 200 OK e uma coleção de objetos Drive no corpo da resposta.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "942CAEB0-13AE-491B-85E4-7557CDC0F25F",
      "driveType": "documentLibrary",
      "name": "Shared Documents",
      "owner": {
        "user": {
          "id": "AE2A1EE9-81A7-423C-ABE4-B945F47509BB",
          "displayName": "Ryan Gregg"
        }
      }
    },
    {
      "id": "C1CD3ED9-0E98-4B0B-82D3-C8FB784B9DCC",
      "driveType": "documentLibrary",
      "name": "Contoso Project Files",
      "owner": {
        "user": {
          "id": "406B2281-18E8-4416-9857-38C531B904F1",
          "displayName": "Daron Spektor"
        }
      }
    }
  ]
}

Comentários

A maioria dos usuários só terá um único recurso Drive.

Grupos e Sites podem ter vários recursos de unidade disponíveis.

Unidades com a faceta sistema estão ocultas por padrão. Para listá-los, inclua system na instrução $select.

Compartilhar via