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âmetros | Descrição |
| entire | Retorna os resultados que contêm a palavra em qualquer parte do e-mail. |
| content | Executa a operação de pesquisa para o valor fornecido somente dentro do conteúdo 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 |
| assunto | 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. |
| fileContent | Retorna 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âmetro | Valores permitidos | Exemplo |
| 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 | fromDate:12-set-2017 |
| inclspamtrash | Inclua este parâmetro se você também quer ver os resultados das pastas de spam e da lixeira ao executar uma pesquisa. inclspamtrash:true | inclspamtrash:true |
groupResult | Inclua esse parâmetro se quiser que os resultados da pesquisa que fazem parte da mesma conversa sejam agrupados. Esse valor será definido como falso por padrão. Defina o valor do parâmetro como true (verdadeiro) se quiser agrupar os e-mails. | groupResult:true |
Operadores:
Ao incluir vários parâmetros na pesquisa, os diferentes parâmetros podem ser combinados usando o operador :: e o operador OR.
Para passar o texto/valor de pesquisa com um parâmetro, use um único sinal de dois pontos – :
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.
Observação:
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.
