Compartilhar via


Listar os filhos de um driveItem

Namespace: microsoft.graph

Retorne uma coleção de DriveItems na relação children de um DriveItem.

DriveItems com uma faceta folder ou package não nula podem ter um ou mais DriveItems filhos.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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
Application Files.Read.All Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Solicitação HTTP

GET /drives/{drive-id}/items/{item-id}/children
GET /groups/{group-id}/drive/items/{item-id}/children
GET /me/drive/items/{item-id}/children
GET /sites/{site-id}/drive/items/{item-id}/children
GET /users/{user-id}/drive/items/{item-id}/children

Parâmetros de consulta opcionais

Este método suporta os $expandparâmetros de consulta , $select, $skipToken$top e $orderbyOData 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.
if-none-match etag. Se este cabeçalho de solicitação estiver incluso e a eTag (ou cTag) fornecida corresponder à marca atual do arquivo, uma resposta HTTP 304 Not Modified será exibida.

Exemplos

Filhos de lista na raiz da unidade do usuário atual

Para recuperar arquivos na raiz da unidade, use a relação root na unidade e acesse a relação de filhos.

GET /me/drive/root/children

Filhos da lista de um DriveItem com uma ID conhecida

Para recuperar arquivos na raiz da unidade, use a relação root na unidade e acesse a relação de filhos.

GET /drives/{drive-id}/items/{item-id}/children

Filhos da lista de um DriveItem com um caminho conhecido

GET https://graph.microsoft.com/v1.0/drives/{drive-id}/root:/{path-relative-to-root}:/children

Resposta

Se tiver êxito, esse método retornará a lista de itens no conjunto de filhos do item de destino. A coleção secundária será composta de recursos driveItem.

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

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

Observação: Se uma coleção exceder o tamanho de página padrão (200 itens), a propriedade @odata.nextLink será retornada na resposta para indicar que mais itens estão disponíveis e fornecer a URL da solicitação para a próxima página de itens.

Você pode controlar o tamanho da página por meio de parâmetros de cadeia de caracteres de consulta opcional

Respostas de erro

Confira mais informações sobre como os erros são retornados em Respostas de Erros.