Pesquisar drives compartilhados

Para pesquisar um conjunto específico de drives compartilhados, use o campo de string de consulta q com drives.list 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 campo ou termo de consulta a ser pesquisado.

  • operator especifica a condição para o termo da consulta.

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

Para conferir os termos e operadores de consulta que podem ser usados para filtrar drives compartilhados, consulte Termos e operadores de consulta de pesquisa.

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

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

Exemplos de strings de consulta

A tabela a seguir lista exemplos de algumas strings de consulta básicas para unidades compartilhadas. O código real varia de acordo com a biblioteca de cliente usada para a pesquisa.

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

O que você quer consultar Exemplo Configuração de useDomainAdminAccess
Drives compartilhados criados após 1º de junho de 2017 createdTime > '2017-06-01T12:00:00' true
Drives compartilhados visíveis na visualização padrão hidden = false false
Drives compartilhados com mais de um participante memberCount > 1 true
Drives compartilhados com a palavra "Confidencial" no título e 20 ou mais participantes 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 a palavra "confidencial" no título entre todos os drives compartilhados em que o usuário é participante name contains 'confidential' false
Drives compartilhados sem organizador atribuído organizerCount = 0 true
Drives compartilhados que não contêm o ID da unidade organizacional orgUnitId != 'C03az79cb' true

Consultar vários termos com parênteses

Você pode usar parênteses para agrupar vários termos de consulta. Por exemplo, para procurar unidades compartilhadas criadas 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, então a mesma pesquisa sem parênteses retornaria:

  • Somente drives compartilhados com mais de cinco organizadores 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.