Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Namespace: microsoft.graph
Recupera a lista de recursos Drive disponíveis para um User, Group ou Site de destino.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Files.Read | Files. Read.All, Files. ReadWrite, Files. ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Files.Read | Files. Read.All, Files. ReadWrite, Files. ReadWrite.All |
| Application | Files.Read.All | Files. ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All |
Solicitação HTTP
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.
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 $orderby OData para personalizar a resposta.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
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.
Exemplos
Solicitação
GET /me/drives
Resposta
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#drives",
"value": [
{
"createdDateTime": "2017-07-27T02:41:36Z",
"description": "",
"id": "b!-RIj2DuyvEyV1T4NlOaMHk8XkS_I8MdFlUCq1BlcjgmhRfAj3-Z8RY2VpuvV_tpd",
"lastModifiedDateTime": "2018-03-27T07:34:38Z",
"name": "OneDrive",
"webUrl": "https://m365x214355-my.sharepoint.com/personal/meganb_m365x214355_onmicrosoft_com/Documents",
"driveType": "business",
"createdBy": {
"user": {
"displayName": "System Account"
}
},
"lastModifiedBy": {
"user": {
"email": "MeganB@contoso.com",
"id": "48d31887-5fad-4d73-a9f5-3c356e68a038",
"displayName": "Megan Bowen"
}
},
"owner": {
"user": {
"email": "MeganB@contoso.com",
"id": "48d31887-5fad-4d73-a9f5-3c356e68a038",
"displayName": "Megan Bowen"
}
},
"quota": {
"deleted": 0,
"remaining": 1099217021300,
"state": "normal",
"total": 1099511627776,
"used": 294606476
}
}
]
}
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.