Method: children.list

Lista os filhos de uma pasta.

Solicitação HTTP

GET https://www.googleapis.com/drive/v2/files/{folderId}/children

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
folderId

string

O ID da pasta.

Parâmetros de consulta

Parâmetros
maxResults

integer

Número máximo de filhos a serem retornados.

orderBy

string

Uma lista separada por vírgulas de chaves de classificação. As chaves válidas são createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred e title. Cada tecla classifica em ordem crescente por padrão, mas pode ser invertida com o modificador desc. Exemplo de uso: ?orderBy=folder,Configurado Data desc,title. No momento, há uma limitação para usuários com aproximadamente um milhão de arquivos, em que a ordem de classificação solicitada é ignorada.

pageToken

string

Token da página para filhos.

q

string

String de consulta para pesquisar filhos.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de filhos de um arquivo.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (ChildReference)
    }
  ]
}
Campos
nextPageToken

string

O token de página para a próxima página de filhos. Será ausente se o fim da lista filha for atingido. Se o token for rejeitado por qualquer motivo, ele deverá ser descartado e a paginação deverá ser reiniciada na primeira página de resultados.

kind

string

É sempre drive#childList.

etag

string

A ETag da lista.

items[]

object (ChildReference)

A lista de filhos. Se nextPageToken for preenchida, essa lista poderá estar incompleta, e outra página de resultados deverá ser buscada.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

Alguns escopos são restritos e exigem uma avaliação de segurança para serem usados pelo app. Para mais informações, consulte o Guia de autorização.