- Solicitação HTTP
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
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 |
Número máximo de unidades compartilhadas a serem retornadas por página. |
pageToken |
Token de página para drives compartilhados. |
q |
String de consulta para pesquisar drives compartilhados. |
useDomainAdminAccess |
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 ( |
Campos | |
---|---|
nextPageToken |
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 |
Identifica o tipo de recurso. Valor: a string fixa |
drives[] |
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.