Termos e operadores da consulta de pesquisa

Este guia de referência fornece termos e operadores de consulta que podem ser usados com o 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 sua pesquisa resultados.

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 o recurso files de referência.

Termo de consulta Operadores válidos Uso
name contains, =, != Nome do arquivo. Coloque o texto entre aspas simples ('). Ignore 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 o texto entre aspas simples ('). Ignore aspas simples em consultas com \', como 'Valentine\'s Day'.
mimeType contains, =, != Tipo MIME do arquivo. Coloque o texto entre aspas simples ('). Ignore 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 estão na pasta Compartilhados comigo Google Cloud. 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 só executa a correspondência de prefixo para um name. Por exemplo, suponha que você tenha um nome de HelloWorld. Uma consulta de name contains 'Hello' retorna uma resultado, mas uma consulta de name contains 'World', não.

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

  • O operador contains faz a correspondência com uma frase alfanumérica exata se for entre aspas duplas. Por exemplo, se o fullText de um documento contiver 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 argumento texto de um documento contém a string "Hello_world", depois a consulta fullText contains '"Hello world"' retorna um resultado.

  • Os termos owners, writers e readers são refletidos indiretamente no permissions e consulte a 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, acesse string de consulta de arquivo exemplos.

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 o recurso drives de referência.

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 o texto entre aspas simples ('). Ignore 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

Para mais exemplos de pesquisas com strings de consulta, acesse String de consulta do drive compartilhado exemplos.