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 estas três partes:
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.
Confira os termos e operadores de consulta que podem ser usados para filtrar drives compartilhados em Termos e operadores de consulta de 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
Exemplos de string de consulta
A tabela a seguir mostra exemplos de algumas strings de consulta básicas para drives compartilhados. O código real difere dependendo da biblioteca de cliente usada na pesquisa.
O que você quer consultar | Exemplo | Configuração de useDomainAdminAccess |
---|---|---|
Drives compartilhados criados após 1o 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 participantes ou mais | 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 de que o usuário participa | 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 cinco organizadores ou 20 membros.
A API Drive avalia os operadores and
e or
da esquerda para a direita, de modo que a mesma pesquisa sem parênteses retornaria:
- Somente drives compartilhados com mais de cinco organizadores criados após 1o de janeiro de 2019
- Todos os drives compartilhados com mais de 20 membros, mesmo os criados antes de 1o de janeiro de 2019.