Listar os filhos de um driveItemList children of a driveItem

Retorne uma coleção de DriveItems na relação children de um DriveItem.Return a collection of DriveItems in the children relationship of a DriveItem.

DriveItems com uma faceta folder ou package não nula podem ter um ou mais DriveItems filhos.DriveItems with a non-null folder or package facet can have one or more child DriveItems.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
AplicativoApplication Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Solicitação HTTPHTTP request

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 opcionaisOptional query parameters

Este método oferece suporte aos Parâmetros de consulta OData $expand, $select, $skipToken, $top e $orderby para personalizar a resposta.This method supports the $expand, $select, $skipToken, $top and $orderby OData query parameters to customize the response.

Cabeçalhos de solicitação opcionaisOptional request headers

NomeName ValorValue DescriçãoDescription
if-none-matchif-none-match etagetag 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.If this request header is included and the eTag (or cTag) provided matches the current tag on the file, an HTTP 304 Not Modified response is returned.

ExemplosExamples

Filhos de lista na raiz da unidade do usuário atualList children in the root of the current user's drive

Para recuperar arquivos na raiz da unidade, use a relação root na unidade e acesse a relação de filhos.To retrieve files in the root of the drive, use the root relationship on the drive, then access the children relationship.

GET /me/drive/root/children

Filhos da lista de um DriveItem com uma ID conhecidaList children of a DriveItem with a known ID

Para recuperar arquivos na raiz da unidade, use a relação root na unidade e acesse a relação de filhos.To retrieve files in the root of the drive, use the root relationship on the drive, then access the children relationship.

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

Filhos da lista de um DriveItem com um caminho conhecidoList children of a DriveItem with a known path

GET /drives/{drive-id}/root:/{path-relative-to-root}:/children

RespostaResponse

Se tiver êxito, esse método retornará a lista de itens no conjunto de filhos do item de destino.If successful, this method returns the list of items in the children collection of the target item. A coleção secundária será composta de recursos driveItem.The children collection will be composed of driveItem resources.

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.Note: If a collection exceeds the default page size (200 items), the @odata.nextLink property is returned in the response to indicate more items are available and provide the request URL for the next page of items.

Você pode controlar o tamanho da página por meio de parâmetros de cadeia de caracteres de consulta opcionalYou can control the page size through optional query string parameters

Respostas de erroError responses

Confira mais informações sobre como os erros são retornados em Respostas de Erros.See Error Responses for more info about how errors are returned.