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 exemplos de pesquisas de drives compartilhados, consulte 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 em que pesquisar.

• 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 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 de recursos files.

Importante: os termos de consulta a seguir usam campos da API Drive v3. Alguns campos de recursos foram alterados entre a v2 e a v3. Por exemplo, files.name substitui files.title. Se você estiver usando a API Drive v2, ajuste essas consultas para usar os campos da v2. Para mais informações, consulte a referência de comparação da API Drive v2 e v3.

Termo de consulta	Operadores válidos	Uso
name	contains, =, !=	Nome do arquivo. Coloque entre aspas simples ('). Escape as aspas simples nas 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 entre aspas simples ('). Escape as aspas simples nas consultas com \', como 'Valentine\'s Day'.
mimeType	contains, =, !=	Tipo MIME do arquivo. Coloque entre aspas simples ('). Escape as aspas simples nas consultas com \', 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, 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 a datas constantes.
viewedByMeTime	<=, <, =, !=, >, >=	Data em que o usuário visualizou um arquivo pela última vez. Formato RFC 3339, 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 a datas constantes.
trashed	=, !=	Se o arquivo está na lixeira ou não. Pode ser true ou false.
starred	=, !=	Se o arquivo está marcado com estrela ou não. Pode ser true ou false.
parents	in	Se a coleção de pais 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 permissions referência de recursos.
readers	in	Usuários ou grupos que têm permissão para ler o arquivo. Consulte a permissions referência de recursos.
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 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 de arquivo personalizadas privadas.
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 para o qual o atalho aponta.

A seguir, demonstramos combinações de operadores e termos de consulta:

• O operador contains só executa a 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ó executa 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", somente a consulta fullText contains 'HelloWorld' retornará um resultado.

• O operador contains corresponde a uma frase 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"' retornará um resultado, mas a consulta fullText contains '"Hello world"' não.

  • Se o texto completo de um documento contiver a string "Hello_world", então a consulta fullText contains '"Hello world"' ainda retornará um resultado, já que o sublinhado na string do documento é tratado como um espaço.

• 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 de drive compartilhado válidos. Para tipos de dados e descrições, consulte a referência de recursos drives.

Termo de consulta	Operadores válidos	Uso	Configuração useDomainAdminAccess
createdTime	<=, <, =, !=, >, >=	Data em que o drive compartilhado foi criado. Formato RFC 3339, 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. Aceita um valor numérico.	true
name	contains, =, !=	Nome do drive compartilhado. Coloque entre aspas simples ('). Escape as aspas simples nas consultas com \', como 'Valentine\'s Day'.	true
organizerCount	<=, <, =, !=, >, >=	Número de usuários e grupos que são organizadores do drive compartilhado. Aceita um valor numérico.	true
orgUnitId	=, !=	O ID da unidade organizacional de um drive compartilhado. Aceita um valor de string.	true

Observação: para mais informações sobre a configuração useDomainAdminAccess, consulte o método drives.list.

Para mais exemplos de pesquisas de strings de consulta, consulte strings de consulta de drives compartilhados exemplos.

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