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.

Para exemplos de pesquisa de arquivos, consulte Pesquisar arquivos e pastas.

Para ver exemplos de pesquisas de drives compartilhados, consulte 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 outro.
!= O conteúdo de uma string ou 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 Retorna itens que correspondem às duas consultas.
or Retorna itens que correspondem 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 de consulta de arquivo válidos. 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 entre aspas simples ('). Use o caractere de escape \' em consultas com aspas simples, 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 entre aspas simples ('). Use o caractere de escape \' em consultas com aspas simples, como 'Valentine\'s Day'.
mimeType contains, =, != Tipo MIME do arquivo. Coloque entre aspas simples ('). Use o caractere de escape \' em consultas com aspas simples, como 'Valentine\'s Day'. Para mais informações sobre tipos MIME, consulte Tipos MIME compatíveis com o Google Workspace e o Google Drive.
modifiedTime <=, <, =, !=, >, >= Data da última modificação do arquivo. Formato RFC 3339. O fuso horário padrão é UTC, como 2012-06-04T12:00:00-08:00. Campos do tipo date não são comparáveis entre si, apenas com datas constantes.
viewedByMeTime <=, <, =, !=, >, >= Data em que o usuário acessou um arquivo pela última vez. Formato RFC 3339. O fuso horário padrão é UTC, como 2012-06-04T12:00:00-08:00. 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á com estrela ou não. Pode ser true ou false.
parents in Se a coleção de elementos pai 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 do recurso permissions.
readers in Usuários ou grupos com permissão para ler o arquivo. Consulte a referência do recurso permissions.
sharedWithMe =, != Arquivos 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 arquivo foi criado. Use o formato RFC 3339. O fuso horário padrão é UTC, como 2012-06-04T12:00:00-08:00.
properties has Propriedades de arquivo personalizadas públicas.
appProperties has Propriedades personalizadas de arquivos particulares.
visibility =, != O nível de visibilidade do arquivo. Os valores válidos são anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink e limited. Coloque entre aspas simples (').
shortcutDetails.targetId =, != O ID do item a que o atalho aponta.

Confira a seguir exemplos de combinações de operadores e termos de consulta:

  • O operador contains só faz correspondência de prefixo para um termo name. Por exemplo, suponha que você tenha um nome de HelloWorld. Uma consulta de name contains 'Hello' retorna um resultado, mas uma consulta de name contains 'World' não.

  • O operador contains só faz correspondência 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' vai retornar um resultado.

  • O operador contains corresponde a uma frase alfanumérica exata se o operando à direita estiver entre aspas duplas. Por exemplo, se o fullText de um documento contiver a string "Hello there world", a consulta fullText contains '"Hello there"' vai 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"' vai 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, consulte 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. Formato 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 membros do drive compartilhado. Usa um valor numérico. true
name contains, =, != Nome do drive compartilhado. Coloque entre aspas simples ('). Use o caractere de escape \' em consultas com aspas simples, como 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= 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 strings de consulta, consulte exemplos de strings de consulta de drive compartilhado.