Para pesquisar um conjunto específico de drives compartilhados, use o campo q da string de consulta 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.operatorespecifica a condição para o termo da consulta.valuessã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 drives compartilhados. O código real varia de acordo com a biblioteca de cliente usada para a pesquisa.
Também é necessário fazer o escape dos caracteres especiais nos nomes dos arquivos para garantir que a consulta funcione corretamente. Por exemplo, se um nome de arquivo contiver um apóstrofo
(') 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 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 1o de janeiro de 2019 e que tenham mais de 5 organizadores ou 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.