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 de chaves de classificação separada por vírgulas. As chaves válidas são createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred e title. Cada tecla é classificada em ordem crescente por padrão, mas pode ser invertida com o modificador desc. Exemplo de uso: ?orderBy=folder,optimizedDate desc,title. Observe que há uma limitação atual para usuários com aproximadamente um milhão de arquivos em que a ordem de classificação solicitada é ignorada.

pageToken

string

Token de 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 da próxima página filha. Esse campo não estará presente se o fim da lista filha tiver sido atingido. Se o token for rejeitado por qualquer motivo, ele deverá ser descartado e a paginação precisará ser reiniciada a partir da primeira página de resultados.

kind

string

É sempre drive#childList.

etag

string

É a ETag da lista.

items[]

object (ChildReference)

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

Escopos de autorização

Requer um dos seguintes escopos de 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.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 que sejam usados pelo app. Para mais informações, consulte o Guia de autorização.