Sintaxe de pesquisa – Parâmetros e operadores

Sintaxe de busca no Zoho Mail

O Zoho Mail oferece várias opções para pesquisar amplamente a caixa de mensagens e localizar ou obter o conjunto correto de e-mails que você procura. A operação de pesquisa pode ser executada em vários parâmetros e combinações. Quando você usa o Zoho Mail via APIs REST ou usa as integrações de terceiros para trabalhar com o Zoho Mail, pesquisar e-mails, você precisa para criar e usar um valor de string, como searchKey. O searchKey precisa integrar uma sintaxe específica para os resultados da pesquisa a serem retornados como esperado. Os vários parâmetros, operadores e valores permitidos para os parâmetros são explicados abaixo. 

A tabela a seguir fornece os diferentes parâmetros para os quais você pode passar o termo de pesquisa para obter resultados de correspondência. Você pode passar o termo de pesquisa com os seguintes parâmetros no formato parâmetro:<valor de pesquisa>. 

ParâmetrosDescrição
entire Retorna os resultados que contêm a palavra em qualquer parte do e-mail. 
sender

 Retorna os e-mails do remetente específico, se o endereço de email completo for fornecido.

 Se o termo de pesquisa for uma palavra (não um endereço de e-mail), os e-mails com endereço From contendo a palavra no nome do usuário ou no nome do domínio serão retornados nos resultados da pesquisa. 

to

 Os e-mails contendo o endereço especificado na região Para serão retornados. 

Se o termo de pesquisa for uma palavra, os e-mails com endereço Para contendo a palavra especificada no nome do usuário ou no domínio serão retornados.

cc Mesma condição que o parâmetro To
subject Retorna os e-mails que contêm a palavra especificada no Assunto do e-mail 
fileName Retorna os e-mails que contêm a palavra especificada como parte do nome do arquivo anexado. 
fileContentRetorna os e-mails que contêm o texto especificado no conteúdo do arquivo anexado. 

O texto de pesquisa pode ser incluído entre aspas duplas para uma correspondência exata e pesquisa como uma frase. 

Ex:

1. entire:Olá::entire:pessoal

Essa string de pesquisa retorna os e-mails que contêm as palavras "Olá" e "pessoal", em qualquer lugar no conteúdo. As palavras não precisam estar na mesma ordem.

2. entire:"Olá pessoal"

Essa string de pesquisa retorna os e-mails que contêm a frase exata "Olá pessoal" da mesma forma como se encontra entre aspas. 

Critérios de pesquisa adicionais:

Juntamente com o termo de pesquisa acima, você pode especificar critérios de pesquisa adicionais, como pastas, rótulos, anexos, sinalizadores, tipo de e-mail e a data e hora em que o e-mail foi enviado.  

ParâmetroValores permitidosExemplo
has

 O parâmetro has ajuda a filtrar ainda mais os resultados do e-mail. 

has:attachment – E-mails com anexos

has:flags – E-mails com sinalizadores

has:convo – E-mails que fazem parte de uma conversa

in

Você pode incluir este parâmetro para pesquisar em uma pasta específica. 

in:<nome da pasta>

in:Marketing

onde "Marketing" é o nome de uma pasta

label

Você pode incluir este parâmetro para pesquisar e-mails com uma marcação/rótulo específico. 

in:<nome do rótulo>

label:folha de pagamento

onde "folha de pagamento" é o nome de um rótulo

fromDate

toDate

Os parâmetros fromDate e toDate ajudam você a especificar o intervalo de datas a partir do qual especificar os e-mails. 

fromDate: DD-MMM-AAAA
toDate:DD-MMM-AAAA

fromDate:12-set-2017
toDate:30-jun-2018

Inclspamtrash

Inclua este parâmetro se você também quer ver os resultados das pastas de spam e da lixeira ao executar uma pesquisa.
Se você não quer incluir essas pastas, não inclua esse parâmetro na pesquisa.

Inclspamtrash:true

Inclspamtrash:true

Operadores: 

Ao incluir vários parâmetros na pesquisa, os diferentes parâmetros podem ser combinadas usando o operador :: e o operador OR.

Para passar o texto/valor de pesquisa com um parâmetro, use um único sinal de ponto e vírgula – :

Por exemplo, se você deseja pesquisar e-mails contendo o termo "marketing", ele precisa ser mencionado como entire:marketing.

Operador para mencionar a próxima condição:

Se quiser mencionar um conjunto de condições em uma única searchKey, você terá de usar :: para indicar a próxima condição.

Sintaxe: – ::

Exemplo – entire:folha de pagamento::has:attachment

Esta searchKey retorna e-mails que contêm um anexo e o termo "folha de pagamento" em alguma parte do e-mail.

Operador OR:

Sintaxe – :or:

Exemplo – sender:frank@zylker.com::or:to:frank@zylker.com

Esta searchKey lista os e-mails enviados ou recebidos de frank@zylker.com.

Nota:

se não houver nenhum operador mencionado após o operador ::, a operação AND será executada por padrão.

Exemplo de searchKey:

subject:Conta::sender:customercare@creditcard.com::has:attachment

O valor da string acima passou como searchKey retorna o e-mail com o termo Conta no assunto do e-mail de customercare@creditcard.com e com anexos.

Share this post : FacebookTwitter

Ainda não consegue encontrar o que você está procurando?

Escreva para nós: support@zohomail.com