Para pesquisar um conjunto específico de drives compartilhados, use o campo q
da string de consulta
com drives.list
para filtrar os percursos
retornam 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 sua pesquisa resultados.
Veja os termos e operadores de consulta que você pode usar 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 dados 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 unidade de disco O código real varia de acordo com a biblioteca de cliente usada para o pesquisa.
Você também deve escapar os caracteres especiais nos nomes dos arquivos para garantir que
funciona corretamente. Por exemplo, se um nome de arquivo contiver um apóstrofo
('
) e um caractere de barra invertida ("\"
), use uma barra invertida como escape: name
contains 'quinn\'s paper\\essay'
.
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 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 a palavra "confidencial" no título entre todos os drives compartilhados de que o usuário é membro. | name contains 'confidential' |
false |
Drives compartilhados sem um 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
Use parênteses para agrupar vários termos de consulta. Por exemplo, para pesquise drives compartilhados criados depois de 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 depois de 1o de janeiro de 2019 e os que foram ter mais de cinco organizadores ou membros.
A API Drive avalia os operadores and
e or
da esquerda para a direita,
assim, a mesma pesquisa sem parênteses retornaria:
- Apenas drives compartilhados com mais de cinco organizadores criados depois 1o de janeiro de 2019.
- Todos os drives compartilhados com mais de 20 participantes, mesmo os criados antes 1o de janeiro de 2019.