- Solicitação HTTP
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Corpus (em inglês)
- Faça um teste
Lista os arquivos do usuário.
Esse método aceita o parâmetro q
, que é uma consulta de pesquisa que combina um ou mais termos de pesquisa. Para mais informações, consulte o guia Pesquisar arquivos e pastas.
Solicitação HTTP
GET https://www.googleapis.com/drive/v2/files
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de consulta
Parâmetros | |
---|---|
corpora |
Corpos de itens (arquivos/documentos) aos quais a consulta se aplica. Os corpos compatíveis são |
corpus |
Obsoleto: o corpo de itens (arquivos/documentos) ao qual a consulta se aplica. Use |
driveId |
ID do drive compartilhado que será pesquisado. |
includeItemsFromAllDrives |
Indica se os itens em "Meu Drive" e nos drives compartilhados devem ser incluídos nos resultados. |
includeTeamDriveItems |
Obsoleto: use |
maxResults |
O número máximo de arquivos a serem retornados por página. Páginas de resultados parciais ou vazias são possíveis antes mesmo do fim da lista de arquivos. |
orderBy |
Uma lista de chaves de classificação separadas por vírgulas. As chaves válidas são |
pageToken |
Token da página de arquivos. |
projection |
Obsoleto: esse parâmetro não tem função. |
q |
String de consulta para pesquisar arquivos. |
spaces |
Uma lista separada por vírgulas de espaços para consulta. Os valores aceitos são |
supportsAllDrives |
Se o aplicativo solicitante é compatível com "Meu Drive" e drives compartilhados. |
supportsTeamDrives |
Obsoleto: use |
teamDriveId |
Obsoleto: use |
includePermissionsForView |
Especifica quais permissões da visualização adicional devem ser incluídas na resposta. Somente |
includeLabels |
Uma lista separada por vírgulas de IDs de rótulos a serem incluídos na parte |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Uma lista de arquivos.
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,
"incompleteSearch": boolean,
"nextLink": string,
"items": [
{
object ( |
Campos | |
---|---|
nextPageToken |
O token de página para a próxima página de arquivos. Ele estará ausente se o final da lista de arquivos for alcançado. 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 |
É sempre |
etag |
A ETag da lista. |
selfLink |
Um link para voltar para esta lista. |
incompleteSearch |
Se o processo de pesquisa estava incompleto. Se for verdadeiro, alguns resultados de pesquisa podem estar ausentes, pois nem todos os documentos foram pesquisados. Isso pode ocorrer ao pesquisar vários drives com o corpo "allDrives", mas não foi possível pesquisar todos eles. Quando isso acontece, sugere-se que os clientes restrinjam a consulta escolhendo um corpus diferente, como "padrão" ou "drive". |
nextLink |
Um link para a próxima página de arquivos. |
items[] |
A lista de arquivos. Se nextPageToken for preenchido, 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.apps.readonly
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 serem usados pelo app. Para mais informações, consulte o Guia de autorização.
Corpus
Enums | |
---|---|
DEFAULT |
Os itens que o usuário acessou. |
DOMAIN |
Itens compartilhados com o domínio do usuário. |