Termos e operadores da consulta de pesquisa

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 termo name. Por exemplo, suponha que o 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 corresponde a uma frase alfanumérica exata se ela estiver cercada por aspas duplas. Por exemplo, se a 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 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.