Method: drives.list

Lista os drives compartilhados do usuário.

Esse método aceita o parâmetro q, que é uma consulta de pesquisa que combina um ou mais termos de pesquisa. Veja mais informações no guia Pesquisar drives compartilhados.

Solicitação HTTP

GET https://www.googleapis.com/drive/v3/drives

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

Parâmetros de consulta

Parâmetros
pageSize

integer

Número máximo de unidades compartilhadas a serem retornadas por página.

pageToken

string

Token de página para drives compartilhados.

q

string

String de consulta para pesquisar drives compartilhados.

useDomainAdminAccess

boolean

Emita a solicitação como administrador do domínio. Se ela for definida como verdadeira, todos os drives compartilhados do domínio em que o solicitante é administrador serão retornados. Se definido como falso (padrão), um máximo de 1.000 serão retornados, mesmo que haja mais de 1.000.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de drives compartilhados.

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

Representação JSON
{
  "nextPageToken": string,
  "kind": string,
  "drives": [
    {
      object (Drive)
    }
  ]
}
Campos
nextPageToken

string

O token da próxima página dos drives compartilhados. Ele não vai aparecer se o fim da lista tiver sido alcançado. 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. O token de página normalmente é válido por várias horas. No entanto, se novos itens forem adicionados ou removidos, os resultados esperados poderão ser diferentes.

kind

string

Identifica o tipo de recurso. Valor: a string fixa "drive#driveList".

drives[]

object (Drive)

A lista de drives compartilhados. Se nextPageToken estiver preenchido, a lista poderá estar incompleta e uma página adicional de resultados precisará ser buscada.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly

Alguns escopos são restritos e exigem uma avaliação de segurança para que o app possa usá-los. Para mais informações, consulte o guia de autorização.