Obtenha uma pasta especial por nome

Namespace: microsoft.graph

Use a coleção especial para acessar uma pasta especial pelo nome.

Pastas especiais fornecem aliases simples para acessar pastas conhecidas no OneDrive sem a necessidade de pesquisar a pasta pelo caminho (o que exigiria a localização) ou fazer referência à pasta com uma ID. Se uma pasta especial for renomeada ou movida para outro local na unidade de disco, esta sintaxe continuará a localizar a pasta.

As pastas especiais são criadas automaticamente na primeira vez que um aplicativo tenta gravar em uma, caso ainda não existam. Se um usuário excluir uma, ela será recriada quando algo for gravado nela novamente.

Observação: Se você tiver permissões somente leitura e solicitar uma pasta especial que não existe, receberá um 403 Forbidden erro.

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.ReadWrite.AppFolder Files. Read, Files. Read.All, Files. ReadWrite, Files. ReadWrite.All, Sites.Read.All
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

GET /me/drive/special/{name}

Nomes de pasta especial

Os nomes de pasta especial a seguir estão disponíveis no OneDrive e no OneDrive for Business.

Nome Id da pasta Descrição
Documentos documents A pasta Documentos.
Fotos photos A pasta Fotos.
Imagens da Câmera cameraroll A pasta de Backup de Imagens da Câmera.
Raiz de Aplicativo approot Pasta pessoal do aplicativo. Geralmente em /Apps/{Application Name}
Música music A pasta Música.
Gravações recordings A pasta Gravações. Essa opção só está disponível no OneDrive for Business e no SharePoint Online.

Parâmetros de consulta opcionais

Esse método dá suporte aos $expandparâmetros de consulta OData e $select 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

Este método retorna um código de resposta 200 OK e um objeto driveItem no corpo da resposta.

Você pode usar esse método de lidar com uma pasta especial em linha com chamadas adicionais para propriedades ou relações no driveItem.

Exemplos

Exemplo 1: obter uma pasta especial por nome

Solicitação

GET /me/drive/special/{name}

Resposta

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

{
  "id": "0123456789abc",
  "name": "Documents",
  "eTag": "012345819293.1",
  "specialFolder": {
    "name": "documents"
  }
}

Exemplo 2: Obter filhos de uma pasta especial

Para solicitar os filhos de uma pasta especial, você pode solicitar a coleção children ou usar a opção expand para expandir a coleção de filhos.

Solicitação

GET /me/drive/special/{special-folder-name}/children

Resposta

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

{
  "value": [
    {"name": "myfile.jpg", "size": 2048 },
    {"name": "Documents", "folder": { "childCount": 4} },
    {"name": "Photos", "folder": { "childCount": 203} },
    {"name": "my sheet(1).xlsx", "size": 197 }
  ]
}

Comentários

Observação: A faceta specialFolder de DriveItems indica que o item é uma pasta especial e pode ser acessado pelo conjunto special.

Se o aplicativo tiver permissões somente leitura, a solicitação para obter uma pasta especial ou os filhos de uma pasta especial poderá falhar com um 404 Not Found erro ou um 403 Forbidden erro se a pasta especial ainda não existir.

  • Last updated on