Termos e operadores da consulta de pesquisa

Este guia de referência fornece 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.

Veja exemplos de pesquisas de drives compartilhados em Pesquisar drives compartilhados.

Sintaxe da string de consulta

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 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 booleano é igual ao do outro.
!= O conteúdo de uma string ou um booleano não é igual ao do 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á dentro de uma coleção.
and Retorne itens que correspondam às duas consultas.
or Retornar itens que correspondam a qualquer 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 do arquivo

A tabela a seguir lista todos os termos válidos de consulta de arquivos. Para tipos de dados e descrições, consulte a referência do recurso files.

Termo de consulta Operadores válidos Uso
name contains, =, != Nome do arquivo. Coloque aspas simples ('). Troque aspas simples em consultas com \', como 'Valentine\'s Day'.
fullText contains Se as propriedades name, description, indexableText ou o texto no conteúdo ou nos metadados do arquivo correspondem. Coloque aspas simples ('). Troque aspas simples em consultas com \', como 'Valentine\'s Day'.
mimeType contains, =, != Tipo MIME do arquivo. Coloque aspas simples ('). Troque aspas simples em consultas com \', como 'Valentine\'s Day'. Para saber mais sobre os tipos MIME, consulte Tipos MIME compatíveis com o Google Workspace e o Google Drive.
modifiedTime <=, <, =, !=, >, >= Data da última modificação do arquivo. RFC 3339, o fuso horário padrão é UTC, como 2012-06-04T12:00:00-08:00. Os campos do tipo date não são comparáveis entre si, apenas com datas constantes.
viewedByMeTime <=, <, =, !=, >, >= Data em que o usuário visualizou um arquivo pela última vez. RFC 3339, o fuso horário padrão é UTC, como 2012-06-04T12:00:00-08:00. Os campos do tipo date não são comparáveis entre si, apenas com 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 São os 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 do recurso permissions.
readers in Usuários ou grupos que têm permissão para ler o arquivo. Consulte a referência do recurso permissions.
sharedWithMe =, != Os arquivos que estiverem na coleção "Compartilhados comigo" do usuário Todos os usuários do arquivo estão na Lista de controle de acesso (ACL) do arquivo. Pode ser true ou false.
createdTime <=, <, =, !=, >, >= Data de criação do drive compartilhado. Use o formato RFC 3339 (link em inglês). O fuso horário padrão é UTC, como 2012-06-04T12:00:00-08:00.
properties has Propriedades públicas de arquivos personalizados.
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. Coloque o texto entre aspas simples (').
shortcutDetails.targetId =, != O ID do item para o qual o atalho aponta.

Veja a seguir as combinações de operador e termo de consulta:

  • O operador contains executa apenas a correspondência de prefixo para um termo name. Por exemplo, suponha que seu nome seja HelloWorld. Uma consulta de name contains 'Hello' retorna um resultado, mas uma consulta de name contains 'World' não.

  • O operador contains realiza a correspondência apenas em tokens de string inteiros para o termo fullText. Por exemplo, se o texto completo de um documento contiver a string "HelloWorld", somente a consulta fullText contains 'HelloWorld' retornará um resultado.

  • O operador contains faz a correspondência com uma frase alfanumérica exata se ela estiver entre aspas duplas. Por exemplo, se o fullText de um documento tiver a string "Hello there world", a consulta fullText contains '"Hello there"' retornará um resultado, mas a consulta fullText 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 consulta fullText contains '"Hello world"' retornará um resultado.

  • Os termos owners, writers e readers são refletidos indiretamente na lista permissions e se referem ao role 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 strings 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 de drives compartilhados. Para tipos de dados e descrições, consulte a referência do recurso drives.

Termo de consulta Operadores válidos Uso Configuração de useDomainAdminAccess
createdTime <=, <, =, !=, >, >= Data de criação do drive compartilhado. RFC 3339, o fuso horário padrão é UTC, como 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. Assume um valor numérico. true
name contains, =, != Nome do drive compartilhado. Coloque aspas simples ('). Troque aspas simples em consultas com \', como 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= O número de usuários e grupos que são organizadores do drive compartilhado. Assume um valor numérico. true
orgUnitId =, != O ID da unidade organizacional de um drive compartilhado. Assume um valor de string. true

Confira mais exemplos de pesquisas de strings de consulta em exemplos de strings de consulta do drive compartilhado.