Neste guia de referência, apresentamos os termos e operadores de consulta que podem ser usados com a API Google Drive para filtrar arquivos, pastas e drives compartilhados.
Veja exemplos de pesquisa de arquivos em Pesquisar arquivos e pastas.
Confira exemplos de pesquisas de drives compartilhados em Pesquisar drives compartilhados.
Sintaxe da string de consulta
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.
Operadores de consulta
A tabela a seguir lista os operadores de consulta válidos:
Operador | Uso |
---|---|
contains |
O conteúdo de uma string está presente na outra. |
= |
O conteúdo de uma string ou um booleano é igual ao outro. |
!= |
O conteúdo de uma string ou um booleano não é igual ao outro. |
< |
Um valor é menor que outro. |
<= |
Um valor é menor ou igual a outro. |
> |
Um valor é maior que outro. |
>= |
Um valor é maior ou igual a outro. |
in |
Um elemento está contido em uma coleção. |
and |
Retornar itens que correspondam às duas consultas. |
or |
Retornar itens que correspondem a uma das consultas. |
not |
Nega uma consulta de pesquisa. |
has |
Uma coleção contém um elemento que corresponde aos parâmetros. |
Termos de consulta específicos de arquivos
A tabela a seguir lista todos os termos de consulta de arquivo válidos. Para tipos de dados e
descrições, consulte a referência de recursos
files
.
Termo de consulta | Operadores válidos | Uso |
---|---|---|
name |
contains , = , != |
Nome do arquivo. Coloque aspas simples no final (' ). Escape de aspas simples em consultas com \' , como em 'Valentine\'s Day' . |
fullText |
contains |
Define se as propriedades name , description , indexableText ou o texto no conteúdo ou nos metadados do arquivo correspondem. Coloque aspas simples no final (' ). Escape de aspas simples em consultas com \' , como em 'Valentine\'s Day' . |
mimeType |
contains , = , != |
Tipo MIME do arquivo. Coloque aspas simples no final (' ). Escape de aspas simples em consultas com \' , como em 'Valentine\'s Day' . Saiba mais sobre os tipos MIME em Tipos MIME compatíveis com o Google Workspace e o Google Drive. |
modifiedTime |
<= , < , = , != , > , >= |
Data da última modificação do arquivo. RFC 3339 (link em inglês), o fuso horário padrão é UTC, por exemplo, 2012-06-04T12:00:00-08:00 . Os campos do tipo date não são comparáveis entre si, apenas a datas constantes. |
viewedByMeTime |
<= , < , = , != , > , >= |
Data em que o usuário visualizou um arquivo pela última vez. RFC 3339 (link em inglês), o fuso horário padrão é UTC, por exemplo, 2012-06-04T12:00:00-08:00 . Os campos do tipo date não são comparáveis entre si, apenas a datas constantes. |
trashed |
= , != |
Se o arquivo está na lixeira ou não. Pode ser true ou false . |
starred |
= , != |
Se o arquivo está ou não marcado com estrela. Pode ser true ou false . |
parents |
in |
Se a coleção principal contém o ID especificado. |
owners |
in |
Usuários que são proprietários do arquivo. |
writers |
in |
Usuários ou grupos que têm permissão para modificar o arquivo. Consulte a referência de recurso permissions . |
readers |
in |
Usuários ou grupos que têm permissão para ler o arquivo. Consulte a referência de recurso permissions . |
sharedWithMe |
= , != |
Arquivos que estão na coleção "Compartilhados comigo" do usuário Todos os usuários de arquivos estão na lista de controle de acesso (ACL) do arquivo. Pode ser true ou false . |
createdTime |
<= , < , = , != , > , >= |
Data em que o drive compartilhado foi criado. Use o formato RFC 3339 (link em inglês). O fuso horário padrão é UTC, por exemplo, 2012-06-04T12:00:00-08:00 . |
properties |
has |
Propriedades do arquivo público personalizado. |
appProperties |
has |
Propriedades de arquivos particulares personalizados. |
visibility |
= , != |
O nível de visibilidade do arquivo. Os valores válidos são anyoneCanFind , anyoneWithLink , domainCanFind , domainWithLink e limited . Use aspas simples ao redor (' ). |
shortcutDetails.targetId |
= , != |
O código do item para o qual o atalho aponta. |
Veja a seguir uma demonstração das combinações de operador e termo de consulta:
O operador
contains
só realiza a correspondência de prefixo para um termoname
. Por exemplo, suponha que o nome sejaHelloWorld
. Uma consulta dename contains 'Hello'
retorna um resultado, mas uma consulta dename contains 'World'
não.O operador
contains
realiza a correspondência apenas em tokens de string inteiros para o termofullText
. Por exemplo, se o texto completo de um documento contiver a string "HelloWorld", somente a consultafullText contains 'HelloWorld'
retornará um resultado.O operador
contains
corresponde a uma frase alfanumérica exata se ela estiver cercada por aspas duplas. Por exemplo, se afullText
de um documento tiver a string "Hello there world", a consultafullText contains '"Hello there"'
retornará um resultado, mas a consultafullText contains '"Hello world"'
não. Além disso, como a pesquisa é alfanumérica, se o texto completo de um documento contiver a string "Hello_world", a consultafullText contains '"Hello world"'
retornará um resultado.Os termos
owners
,writers
ereaders
são refletidos indiretamente na listapermissions
e se referem aorole
na permissão. Para uma lista completa de permissões de papéis, consulte Papéis e permissões.
Para mais exemplos de pesquisas de string de consulta, confira exemplos de strings de consulta de arquivos.
Termos de consulta específicos do drive compartilhado
A tabela a seguir lista todos os termos de consulta válidos do drive compartilhado. Para tipos de dados e
descrições, consulte a referência de recursos
drives
.
Termo de consulta | Operadores válidos | Uso | Configuração de useDomainAdminAccess |
---|---|---|---|
createdTime |
<= , < , = , != , > , >= |
Data em que o drive compartilhado foi criado. RFC 3339 (link em inglês), o fuso horário padrão é UTC, por exemplo, 2012-06-04T12:00:00-08:00 . |
true |
hidden |
= , != |
Especifica se o drive compartilhado está oculto. Pode ser true ou false . |
false |
memberCount |
<= , < , = , != , > , >= |
Número de usuários e grupos que são participantes do drive compartilhado. Usa um valor numérico. | true |
name |
contains , = , != |
Nome do drive compartilhado. Coloque aspas simples no final (' ). Escape de aspas simples em consultas com \' , como em 'Valentine\'s Day' . |
true |
organizerCount |
<= , < , = , != , > , >= |
O número de usuários e grupos que são organizadores do drive compartilhado. Usa um valor numérico. | true |
orgUnitId |
= , != |
O ID da unidade organizacional de um drive compartilhado. Usa um valor de string. | true |
Para mais exemplos de pesquisas de string de consulta, confira exemplos de string de consulta de drive compartilhado.
Temas relacionados
- Pesquisar arquivos e pastas
- Pesquisar drives compartilhados
- Tipos MIME compatíveis com o Google Workspace e o Google Drive
- Papéis e permissões