Usar operadores para refinar uma pesquisa no Vault

Insira palavras-chave e termos de pesquisa no campo Termos para restringir ou ampliar uma pesquisa dos dados do Google Workspace da sua organização usando o Google Vault. Os operadores de pesquisa usados variam conforme o serviço. O Vault é compatível com operadores de pesquisa nestes produtos: Gmail, Grupos do Google, Drive, Chat e Voice, mas não na Agenda.

Noções básicas de pesquisa

  • Digite os operadores de pesquisa em inglês, mesmo que o pessoal da organização use outros idiomas para se comunicar. Com esses operadores, também é possível encontrar palavras e frases em outros idiomas.
  • Para a maioria dos serviços, o Vault considera que há um operador AND entre os termos de pesquisa quando nenhum operador booleano é especificado.
  • O Vault ignora sinais de pontuação e letras maiúsculas e minúsculas em palavras-chave e frases.

  • Para excluir resultados que correspondam ao termo de pesquisa, coloque um hífen (-) ou NOT antes do operador. Por exemplo, para excluir as mensagens enviadas para nomedeusuario1 dos resultados da pesquisa, digite ‑to:username1 ou NOT to:username1.

    Observação:se o termo de pesquisa começar com hífen, como -1000%, coloque o termo individual entre aspas para que ele não seja interpretado como um operador NOT. Por exemplo, -1000% (sem operador de pesquisa) corresponde a qualquer termo que não contenha 1000,, enquanto "-1000%" corresponde a -1000 e 1000, porque, com aspas, o hífen e a porcentagem são ignorados.

  • Para pesquisar mensagens ou itens pelo nome da conta, sempre inclua dois-pontos (:) sem espaços após o operador. Por exemplo, use to:username1 no Gmail e owner:username2 no Google Drive.

  • Quando digitar vários valores para o mesmo operador, agrupe-os entre parênteses. Por exemplo, para pesquisar dois destinatários de uma mensagem do Gmail, digite to:(username1 OR username2).

  • Os operadores booleanos (AND, OR, NOT e AROUND) precisam estar em maiúsculas. Caso contrário, eles serão tratados como palavras-chave. Para garantir que seus termos sejam processados corretamente, leia as diretrizes de complexidade de termos nesta página.

Operadores de pesquisa

Operadores de pesquisa do Gmail e do Grupos do Google

Operadores de pesquisa disponíveis:

Operadores de pesquisa gerais

Operador Descrição e uso
AND

Encontre mensagens que incluam dois termos de pesquisa.

Exemplos:

  • secret AND project (equivalente a secret project)
  • from:username1 AND to:username2
OR

Encontre mensagens que incluam um dos dois termos de pesquisa digitados (ou ambos). Para garantir que sua consulta seja processada corretamente, use menos de 20 termos OR. Se a consulta incluir um termo de data, como sent_before:, use menos de 10 termos OR .

Exemplos:

  • secret OR alert
  • from:(username1 OR username2)
  • "huge losses" OR "-1000%" (Observação: coloque os termos que começam com hífens entre aspas para que eles não sejam tratados como operadores NOT)
NOT

Encontre mensagens que não incluam um determinado termo de pesquisa.

Exemplos:

  • NOT personal
  • from:username1 NOT to:username2
*

Encontre termos desconhecidos ou com caracteres curinga.

O caractere curinga (*) precisa aparecer no final de um termo de pesquisa. Por exemplo, invit* retorna mensagens com convite ou convidar (ou ambos). No entanto, *ation não é compatível.

Você pode digitar um caractere curinga (*) no início de um endereço de e-mail para encontrar todas as mensagens enviadas ou recebidas por um domínio externo.

Observação: se o caractere curinga resultar em uma frase com mais de cem palavras, vai ocorrer um erro na pesquisa. Faça uma pesquisa mais específica.

Exemplos:

  • invit*
  • from:*@solarmora.com
AROUND number

Encontre mensagens com palavras próximas umas das outras.

Digite um número para especificar quantas palavras podem separar os termos. Adicione aspas para ver apenas mensagens em que a primeira palavra aparece antes da segunda.

Observações de uso:

  • AROUND não pode ser combinado com uma pesquisa com caractere curinga (*).
  • AROUND não pode ser usado com parênteses ou frases com várias palavras.
  • Use no máximo dois termos AROUND em uma consulta.
  • Defina a distância AROUND para menos de 20.

Exemplo:

  • tax AROUND 10 audit
  • "secret AROUND 15 project"

Texto, assunto ou ID

Operador Descrição e uso
nenhum operador

Encontre mensagens que contenham uma palavra ou frase no corpo ou no assunto.

Para pesquisar uma frase, coloque as palavras entre aspas duplas (").

Exemplo:

  • alert
  • "Solarmora, Inc." Observação:a pesquisa ignora o uso de letras maiúsculas e minúsculas e a pontuação das frases entre aspas. Este exemplo também corresponde a solarmora inc e Solamora! inc.
subject:

Encontre mensagens com uma palavra ou frase específica no assunto.

Para pesquisar assuntos com várias palavras, substitua cada espaço por um hífen (-).

Exemplo:

  • subject:secret-product-launch-plans
rfc822msgid:

Encontre mensagens pelo Message-ID, ou ID da mensagem. Esse ID é um identificador exclusivo das mensagens adicionadas por servidores de e-mail. Os clientes e servidores de e-mail usam esse identificador para rastrear mensagens. Para ver o cabeçalho do Message-ID, abra uma mensagem no Vault e clique em Original.

Exemplo:

  • rfc822msgid:AANLkTilQ5MWSp7-iE6SKepvOl-
    Spjupgr1NZTiLGu16Z@mail.solarmora.com

Conta

Operador Descrição e uso
to:

Encontre as mensagens recebidas por uma conta. A conta pode ser um endereço de e-mail de grupo.

O Vault retorna todas as mensagens que incluem a conta nos campos "to", "cc" ou "bcc".

Se você pesquisar as contas no domínio da sua organização, não vai precisar especificar o domínio. Por exemplo, se o domínio for solarmora.com, uma pesquisa por to:sales será igual a uma pesquisa por to:sales@solarmora.com.

Exemplos:

  • to:username1
  • to:finance-team@solarmora.com
from:

Encontre mensagens enviadas por uma determinada conta. Observação:

  • As mensagens do Gmail enviadas em nome do usuário pelos Serviços do Google, como as notificações de comentários no Drive, talvez não sejam incluídas porque apenas o nome do usuário é informado, e não o nome de usuário da conta.
  • Em uma pesquisa do Gmail, uma pesquisa de mensagens enviadas por um Grupo do Google (por exemplo, from:group@solarmora.com) só vai retornar mensagens se um usuário tiver feito a inscrição no grupo e receber resumos por e-mail. As notificações de todas as mensagens são enviadas das contas individuais dos remetentes.

Exemplos:

  • from:username1
  • from:finance-team@solarmora.com
cc:

Encontre mensagens com a conta especificada no campo "cc".

Exemplo:

cc:username1
bcc:

Encontre mensagens com a conta especificada no campo "bcc".

Exemplo:

  • bcc:username1
replyto:

Encontre mensagens em que a conta especificada é o destinatário das respostas.

Exemplo:

  • replyto:username1
list:

Encontre mensagens enviadas ou recebidas por um grupo.

Exemplo:

  • list:company-announcements
listid:

Encontre uma mensagem com base no identificador exclusivo do grupo que a recebeu.

O List-ID (ID da lista) é incluído nos cabeçalhos das mensagens enviadas ou recebidas no Grupos do Google. Para encontrar o List-ID de uma mensagem, abra uma conversa no Vault e clique em Original no canto superior direito.

Exemplo:

  • listid:employee-announcements.solarmora.com
deliveredto:

Limite os resultados da pesquisa às mensagens do Gmail entregues na conta especificada.

Exemplo:

  • deliveredto:username1

Marcador, pasta e tipo

Operador Descrição e uso
label:

Encontre ou exclua mensagens com um marcador específico do Gmail. Este operador não pode ser usado nas mensagens em grupos do Google.

Se o marcador tiver espaços, substitua-os por hifens (-). Adicione uma barra (/) para pesquisar um marcador aninhado. Não é possível usar o caractere curinga (*) para pesquisar marcadores.

Exemplos:

  • Encontre mensagens com um marcador aninhado.

    label:purchase-orders/approved

  • Encontre mensagens removidas da Lixeira, mas que ainda não foram eliminadas.

    in:trash AND label:^deleted

  • Encontre mensagens removidas das caixas de e-mails da conta devido à expiração de uma regra de retenção.

    label:^vault_deletion

  • Exclua mensagens em quarentena.

    -label:^admin_quarantine

  • Encontre mensagens enviadas pelo modo confidencial do Gmail.

    label:confidentialmode

  • Encontrar mensagens aguardando envio de acordo com uma programação

    label:^scheduled

  • Encontrar mensagens que foram enviadas de acordo com uma programação

    label:^f_sd

  • Exclua versões antigas de mensagens de rascunho.

    -label:^r_ad

Observação: se você pesquisar um marcador gerado pelo sistema, o Vault vai poder retornar um número excessivo de mensagens.
in:

Encontre mensagens em uma pasta específica.

Exemplos:

  • in:inbox
  • in:spam
  • in:trash
is:

Encontre mensagens por tipo ou status.

Opções:

Encontre mensagens do Gmail por status.

  • is:read
    is:sent
    is:starred
    is:unread

Data ou tamanho

Operador Descrição e uso

sent_before:

sent_after:

received_before:

received_after:

Encontre as mensagens de acordo com a data de envio ou recebimento. Digite as datas no formato AAAA-MM-DD.

As correspondências incluem a data especificada. Por exemplo, sent_before:2019-12-16 corresponde às mensagens enviadas em 16 de dezembro de 2019 ou antes disso.

Exemplo:

  • sent_after:2017-12-16

older_than:

newer_than:

Encontre mensagens mais antigas ou recentes do que um período específico.

As unidades de tempo compatíveis são d (dia), m (mês) e y (ano).

Exemplo:

  • newer_than:1m
size:

Encontre mensagens por tamanho em bytes, incluindo anexos.

Você pode usar :, <, >, =, <= e >= com esse operador.

Exemplo:

  • size>=1000000

smaller:

larger:

Encontre mensagens menores ou maiores que um determinado tamanho em kilobytes ou megabytes com anexos.

Use K para kilobytes e M para megabytes.

Exemplo:

  • larger:10M

Propriedades do anexo

Operador Descrição e uso
has:attachment

Encontre mensagens com pelo menos um anexo.

has:attachment
filename:

Encontre mensagens que incluam um anexo com o nome do arquivo informado.

O termo de pesquisa não diferencia maiúsculas de minúsculas e aceita correspondências parciais e caracteres curinga.

Exemplo:

  • filename:secret-plans.pdf
filename_exact:

Encontre mensagens que incluam anexos com o nome exato do arquivo.

Esse termo de pesquisa diferencia maiúsculas de minúsculas.

Exemplo:

  • filename_exact:sEcReT-PlAnS.PdF

Operadores de pesquisa do Drive

Operadores de pesquisa disponíveis:

Operadores de pesquisa gerais

Operador Descrição e uso
nenhum operador

Para tipos de arquivo compatíveis, encontre itens que contenham as palavras-chave ou frases informadas.

Para pesquisar uma frase, coloque as palavras entre aspas duplas ("). O operador não diferencia maiúsculas de minúsculas.

Exemplo:

  • alert
  • "Solarmora, Inc."
AND

Encontre itens que incluam dois termos de pesquisa.

Exemplos:

  • secret AND project
  • owner:username1 AND to:username2
OR

Encontre itens que incluam um dos dois termos de pesquisa (ou ambos).

Exemplos:

  • secret OR confidential
  • type:(spreadsheet OR pdf)
NOT

Encontre itens que não incluam um termo de pesquisa específico.

Exemplos:

  • NOT personal
  • username1 NOT type:image

Conta

Observação:digite a conta como o endereço de e-mail completo. Por exemplo, user1@example.com ou groupA@example.com.

Operador Descrição e uso
owner:

Correspondências

  • Arquivos que pertencem à conta especificada

Sem correspondência

  • Arquivos que pertenciam à conta especificada e foram transferidos para outra conta ou para um drive compartilhado

Exemplo

  • owner:user1@example.com corresponde aos arquivos de propriedade de user1. Não retorna arquivos que pertenciam a user1 e agora pertencem a outra conta.
sharedwith:

Correspondências

  • Todos os arquivos que a conta especificada tem permissão para ver, comentar ou editar
  • Arquivos que pertencem à conta
  • Se a conta especificada tiver permissão devido a uma associação a grupo:
    • Se o grupo tiver menos de 200 participantes, a consulta retornará os arquivos compartilhados com esse grupo.
    • Se o grupo tiver pelo menos 200 participantes, a consulta retornará apenas os arquivos abertos pela conta.
  • Arquivos em pastas compartilhadas com a conta especificada, mesmo se o arquivo não tiver sido compartilhado diretamente

Sem correspondência

  • Arquivos em drives compartilhados em que a conta especificada participa, mas não compartilhados diretamente com ela
  • Arquivos compartilhados com um grupo antes ou depois de a conta especificada participar do grupo

Exemplo

  • sharedwith:user1@example.com retorna arquivos compartilhados com user1 diretamente ou por um pequeno grupo do qual user1 participa.
from:

Correspondências

  • Arquivos compartilhados pela conta especificada com as contas no escopo da pesquisa

Sem correspondência

  • Arquivos compartilhados antes de março de 2021
  • Arquivos compartilhados por link ("Qualquer pessoa com o link pode")

Exemplo

  • from:user1@example.com retorna arquivos compartilhados por usuario1.
to:

Correspondências

  • Arquivos compartilhados pelas contas no escopo da pesquisa diretamente com a conta especificada
  • Se a conta especificada tiver permissão devido a uma associação ao grupo, os arquivos a seguir vão corresponder:
    • Arquivos compartilhados com o grupo (se o grupo tiver menos de 200 participantes)
    • Arquivos compartilhados com o grupo aberto pela conta (se o grupo tiver 200 ou mais participantes)

    Observação: somente arquivos compartilhados com o grupo enquanto a conta participa dele são incluídos.

Sem correspondência

  • Arquivos compartilhados antes de março de 2021
  • Arquivos em pastas compartilhadas com a conta especificada, mas que não foram compartilhados diretamente
  • Arquivos em drives compartilhados de que a conta especificada faz parte, mas que não foram compartilhados diretamente com ela
  • Arquivos compartilhados com um grupo antes ou depois de a conta especificada participar do grupo
  • Arquivos que pertencem à conta especificada

Exemplo

  • to:admin@solarmora.com retorna arquivos compartilhados diretamente com admin@solarmora.com. Arquivos a que admin@solarmora.com tem acesso indireto em um drive compartilhado não retornam.

Propriedades do item

Operador Descrição e uso
is:

Localize itens marcados com estrela.

is:starred
in:

Encontre ou exclua itens movidos para a lixeira.

in:trash

-in:trash
type:

Encontre itens por tipo.

Exemplo:

  • type:presentation

Tipos de itens compatíveis:

  • audio
  • document (todos os arquivos do Google e PDFs)
  • drawing (Desenhos Google)
  • form (Google Formulários)
  • image
  • jam (arquivos do Jamboard)
  • pdf
  • presentation (Apresentações Google)
  • site (novo Google Sites)
  • spreadsheet (Planilhas Google)
  • textdoc (Google Docs)
  • vid (Google Vids)
  • video

before:

after:

Encontre itens com base na data de edição. Digite as datas no formato AAAA-MM-DD.

As correspondências são apenas com a data especificada. Por exemplo, before:2019-12-16 corresponde aos itens editados em 15 de dezembro de 2019 ou antes disso.

Exemplo:

  • before:2017-12-31
title:

Encontre itens por título.

Exemplo:

  • title:"secret product launch plans"

Operadores de pesquisa do Google Chat

Operadores de pesquisa disponíveis:

Observação:o Chat não é compatível com operadores booleanos ou termos entre aspas.

Operadores de pesquisa gerais

Operador Descrição e uso
+

Encontre mensagens que contenham uma ou mais palavras-chave.

A pesquisa corresponde exatamente à palavra-chave, então uma pesquisa por +tax não retorna mensagens que contêm "tributos".

Exemplo:

  • +secret +project
-

Exclua mensagens que contenham uma ou mais palavras-chave.

A pesquisa corresponde exatamente a cada palavra-chave, então uma pesquisa por -finance ainda retorna mensagens que contêm "finanças".

Exemplo:

  • -personal

Conta

Operador Descrição e uso
from:

Encontre mensagens diretas enviadas por um usuário e as conversas de que ele participou.

Esse operador requer o nome completo da conta, inclusive o domínio da organização.

Exemplo:

  • from:jane@solarmora.com
at:

Encontre conversas que mencionam um determinado usuário.

Esse operador requer o nome completo da conta, inclusive o domínio da organização.

Exemplo:

  • at:jack@solarmora.com

Data

Operador Descrição e uso

before:

after:

Encontre mensagens com base na data de criação.

Digite as datas no formato AAAA/MM/DD.

A pesquisa usa UTC por padrão. Use o operador tz: para especificar um fuso horário.

As correspondências incluem a data especificada. Exemplo:

  • before:2019/12/16 corresponde às mensagens enviadas em 16 de dezembro de 2019 ou antes disso.
  • after:2019/12/16 corresponde às mensagens enviadas em 16 de dezembro de 2019 ou depois disso.

Exemplos:

  • after:2018/11/21
  • before:2019/03/16 tz:GMT-08:00

older_than:

newer_than:

Encontre mensagens mais antigas ou recentes do que um período específico.

As unidades de tempo compatíveis são d (dia), m (mês) e y (ano).

A pesquisa usa UTC por padrão. Use o operador tz: para especificar um fuso horário.

Exemplo:

  • older_than:1y
tz:

Especifique um fuso horário para pesquisas com base na data e na hora.

Especifique o fuso horário com GMT+ ou GMT- e a diferença do UTC.

Exemplo:

  • older_than:1y tz:GMT-05:30

Propriedades de mensagem e do espaço do Chat

Operador Descrição e uso
has:

Encontre mensagens que incluam um tipo específico de conteúdo.

Exemplo:

  • has:video

Tipos de conteúdo permitidos:

  • file
  • doc
  • sheet
  • slide
  • url
  • video
  • pdf
  • image
is:

Pesquise apenas mensagens diretas ou apenas mensagens em espaços. Você também pode pesquisar mensagens em um tipo específico de sala.

Opções:

  • is:dm (para mensagens diretas)
  • is:room (para mensagens em espaços e conversas em grupo)
  • is:externalmanaged (para mensagens criadas por usuários externos)

    Depois de 1º de agosto de 2025, esse operador poderá ser usado para baixar uma cópia das conversas individuais criadas por usuários fora da sua organização que podem ser afetadas pela mudança nas políticas de retenção de mensagens diretas. Ela não retorna dados em mensagens diretas em grupo ou espaços.

Operadores de pesquisa do Google Voice

Operadores de pesquisa disponíveis:

Operadores de pesquisa gerais

Operador Descrição e uso
message:

Encontre mensagens de texto que incluam uma palavra-chave. Quando você digita uma palavra sem operador de pesquisa, o Vault pressupõe message:.

Exemplos:

  • message:alert
  • alert
AND

Encontre mensagens de texto, correios de voz e registros de chamadas que correspondam a dois termos de pesquisa. Quando você digita vários termos de pesquisa, o Vault pressupõe AND entre eles.

Exemplos:

  • secret AND project (equivalente a secret project)
  • before:2020-01-31 AND with:+14155550132
OR

Encontre mensagens de texto, correios de voz e registros de chamadas que correspondam a um dos dois termos de pesquisa.

Exemplos:

  • secret OR confidential
  • with:(+14155550132 OR +14155550188)
NOT

Encontre mensagens de texto, correios de voz e registros de chamadas que não incluam um termo de pesquisa.

Exemplos:

  • NOT personal
  • with:+14155550132 NOT with:+14155550188

Número de telefone ou data

Operador Descrição e uso
with:

Encontre mensagens de texto e eventos de registro de chamadas que envolvam um número de telefone e correios de voz de um número de telefone.

Ao pesquisar por número de telefone, inclua o seguinte:

  • O sinal de mais (+)
  • um código de país
  • O número completo e o código de área

Exemplo:

  • with:+14155550132
before:
after:

Encontre mensagens de texto, correios de voz e transcrições e eventos de registro de chamadas que ocorreram antes ou após uma data.

A pesquisa se refere às 23h59 UTC-7 no dia em que a mensagem de texto foi enviada, o correio de voz foi criado ou a chamada foi feita ou recebida.

As correspondências são apenas com a data especificada. Por exemplo, before:2019-12-16 corresponde às mensagens enviadas em 15 de dezembro de 2019 ou antes disso. Para fazer uma pesquisa inclusiva, digite os valores nos campos Data do envio em vez de digitar esses operadores de pesquisa em Termos.

Exemplos:

  • before:2020-01-31

Tipo de dados ou anexo

Operador Descrição e uso
is:

Encontre um tipo específico de dados do Google Voice.

É possível pesquisar os seguintes tipos:

  • text_message: mensagens de texto
  • voicemail: transcrições do correio de voz
  • received_call: eventos de registro de chamadas recebidas atendidas
  • placed_call: eventos de registro de chamadas efetuadas
  • missed_call: eventos de registro de chamadas recebidas não atendidas

Exemplos:

  • is:text_message after:2020-01-01 with:+14155550132
  • is:voicemail with:+14155550132
has:attachment

Encontre mensagens de texto que tenham um anexo.

Exemplos:

  • has:attachment
  • with:+14155550132 AND has:attachment

Resolver problemas de consulta

Verificar se há erros de sintaxe

Caso seus termos de pesquisa retornem um erro ou não funcionem como esperado, o motivo mais comum é um erro de sintaxe. Às vezes, uma consulta pode ser muito complexa para o serviço processar. Confira alguns erros comuns:

  • Valor de operador ausente, como to: em vez de to:username1.
  • Faltam parênteses, como from:(username1 OR username2 em vez de from:(username1 OR username2)
  • Aspas faltando (Gmail e Drive), como Solarmora, Inc. (tratadas como duas palavras-chave) em vez de "Solarmora, Inc." (tratadas como uma frase-chave)
  • Caractere curinga (*) em uma consulta para um serviço diferente do Gmail. (o único produto em que é possível usar caracteres curinga)

Analise a complexidade do termo de pesquisa

Para garantir que seus termos sejam processados corretamente, eles devem atender às seguintes diretrizes:

  • Use menos de 20 termos OR. Se a consulta incluir um operador de data (como sent_before:), use menos de 10 termos OR.
  • Use no máximo dois operadores AROUND em uma consulta.
  • Defina a distância AROUND para menos de 20.
  • Considere dividir consultas longas em consultas equivalentes menores. Por exemplo, (tax AND audit) OR (secret AND project) pode ser executado como duas consultas separadas:
    1. (tax AND audit)
    2. (secret AND project)

Desativar extensões do navegador

Algumas extensões do navegador podem causar resultados de consulta inesperados. Para isolar quaisquer problemas, tente desligar as extensões do navegador uma por uma. Execute a consulta após cada desativação para saber se ela afeta seus resultados.