Pesquisar drives compartilhados

Este guia explica como a API Google Drive oferece várias maneiras de pesquisar drives compartilhados.

Para pesquisar um conjunto específico de drives compartilhados, use o campo da string de consulta q com o método list no recurso drives para filtrar os drives a serem retornados combinando um ou mais termos de pesquisa.

Uma string de consulta contém as três partes a seguir:

query_term operator values

Em que:

  • query_term é o termo ou campo de consulta a ser pesquisado.

  • operator especifica a condição do termo de consulta.

  • values são os valores específicos que você quer usar para filtrar os resultados da pesquisa.

Por exemplo, a string de consulta a seguir filtra a pesquisa para retornar apenas drives compartilhados com o nome "Recursos da API Google Drive".

q: name = 'Google Drive API resources' & useDomainAdminAccess=false

Para conferir todos os termos de consulta de drives compartilhados, consulte Termos de consulta específicos de drives compartilhados.

Para conferir todos os operadores de consulta que podem ser usados para criar uma consulta, consulte Operadores de consulta.

Exemplos de strings de consulta

A tabela a seguir lista exemplos de algumas strings de consulta básicas para drives compartilhados. O código real varia dependendo da biblioteca de cliente usada na pesquisa.

Você também precisa fazer o escape de caracteres especiais nos nomes de arquivos para garantir que a consulta funcione corretamente. Por exemplo, se um nome de arquivo contiver um apóstrofo (') e uma barra invertida ("\"), use uma barra invertida para fazer o escape deles: name contains 'quinn\'s paper\\essay'.

O que consultar Exemplo Configuração de useDomainAdminAccess
Operador de correspondência de string (contains)
Drives compartilhados com a palavra "confidencial" no título entre todos os drives compartilhados de que o usuário é membro name contains 'confidential' false
Operadores de igualdade e desigualdade (=, !=)
Drives compartilhados visíveis na visualização padrão hidden = false false
Drives compartilhados ocultos da visualização padrão hidden = true false
Drives compartilhados sem organizador atribuído organizerCount = 0 true
Drives compartilhados com exatamente um membro memberCount = 1 true
Drives compartilhados que pertencem ao ID da unidade organizacional orgUnitId = 'C03az79cb' true
Drives compartilhados que não contêm o ID da unidade organizacional orgUnitId != 'C03az79cb' true
Drives compartilhados com nomes que não correspondem a um nome específico name != 'Archived Projects' true
Operadores de comparação (>, >=, <, <=)
Drives compartilhados criados após 1º de junho de 2017 createdTime > '2017-06-01T12:00:00' true
Drives compartilhados criados antes de 1º de janeiro de 2023 createdTime < '2023-01-01T00:00:00' true
Drives compartilhados com mais de um membro memberCount > 1 true
Drives compartilhados com menos de cinco membros memberCount < 5 true
Drives compartilhados com três ou menos organizadores organizerCount <= 3 true
Operadores lógicos (and, or, not)
Drives compartilhados com a palavra "confidencial" no título e 20 ou mais membros name contains 'confidential' and memberCount >= 20 true
Drives compartilhados com a palavra "confidencial" no título entre todos os drives compartilhados da organização name contains 'confidential' and orgUnitId = 'C03az79cb' true
Drives compartilhados com nomes que contêm "Projeto" ou "Arquivo" name contains 'Project' or name contains 'Archive' true
Drives compartilhados que não contêm "Rascunho" no nome not name contains 'Draft' true
Drives compartilhados que não pertencem a uma unidade organizacional de destino e foram criados após uma data específica orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' true

Consultar vários termos com parênteses

É possível usar parênteses para agrupar vários termos de consulta. Por exemplo, para pesquisar drives compartilhados criados após uma data específica e que tenham mais de cinco organizadores ou mais de 20 membros, use esta consulta:

createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or memberCount > 20)

Essa pesquisa retorna todos os drives compartilhados criados após 1º de janeiro de 2019 e que têm mais de cinco organizadores ou mais de 20 membros.

A API Drive avalia os operadores and e or da esquerda para a direita. Portanto, a mesma pesquisa sem parênteses retornaria:

  • Apenas drives compartilhados com mais de cinco organizadores que foram criados após 1º de janeiro de 2019.
  • Todos os drives compartilhados com mais de 20 membros, mesmo aqueles criados antes de 1º de janeiro de 2019.