Listar os filhos de um driveItem
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Retorne uma coleção de driveItems na relação filho de um driveItem.
DriveItems com uma pasta ou faceta de pacote não nula podem ter um ou mais driveItems filho.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas |
---|---|---|
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 |
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
Esse método dá suporte aos $expand
parâmetros de consulta , $select
, $skipToken
, $top
e $orderby
OData para personalizar a resposta.
Cabeçalhos de solicitação opcionais
Nome de cabeçalho | Valor | Descriçã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/root/children
Listar filhos de um driveItem com um caminho conhecido
GET https://graph.microsoft.com/beta/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 children é composta por 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 erros
Consulte Respostas de erro para obter mais informações sobre como os erros são retornados.
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de