Syntaxe de recherche : paramètres et opérateurs

Syntaxe de recherche dans Zoho Mail

Zoho Mail vous propose plusieurs options pour effectuer des recherches dans votre boîte de réception, afin de localiser ou de récupérer les e-mails que vous recherchez. L'opération de recherche peut être effectuée à l'aide de différents paramètres et combinaisons. Si vous utilisez Zoho Mail via des API REST, ou si vous utilisez les intégrations tierces qui fonctionnent sur Zoho Mail, vous devez générer et utiliser une valeur de chaîne, comme la clé searchKey, pour rechercher des e-mails. La clé searchKey doit respecter une syntaxe particulière, afin que les résultats de la recherche soient retournés comme prévu. Les divers paramètres, opérateurs et valeurs autorisées pour les paramètres sont expliqués ci-dessous. 

Le tableau suivant présente les différents paramètres pour lesquels vous pouvez appliquer le terme de recherche afin d'obtenir les résultats correspondants. Vous pouvez appliquer le terme de recherche avec les paramètres suivants, au format paramètre:<valeur de recherche>. 

ParamètresDescription
entire Renvoie les résultats qui contiennent le mot indiqué n'importe où dans l'e-mail. 
sender

 Renvoie les e-mails de l'expéditeur spécifique si l'adresse e-mail complète est indiquée.

 Si le terme de recherche est un mot (et non une adresse e-mail), les e-mails dont l'adresse d'expédition contient le mot dans la partie du nom d'utilisateur ou du nom de domaine seront retournés dans les résultats de recherche. 

to

 Les e-mails contenant l'adresse e-mail spécifiée dans le champ To (À) de l'e-mail sont retournés. 

Si le terme de recherche est un mot, les e-mails dont l'adresse de destination contient le mot spécifié dans la partie du nom d'utilisateur ou du nom de domaine seront retournés.

cc Identique au paramètre To
subject Renvoie les e-mails qui contiennent le mot spécifié dans l'objet de l'e-mail. 
fileName Renvoie les e-mails qui contiennent le mot spécifié dans le nom d'un fichier joint. 
fileContentRenvoie les e-mails qui contiennent le texte spécifié dans le contenu du fichier joint. 

Le texte de recherche peut être indiqué entre guillemets doubles pour obtenir une correspondance exacte et rechercher une phrase. 

Ex :

1. entire:Bonjour::entire:tout le monde

Cette chaîne de recherche renvoie les e-mails qui contiennent les mots Bonjour et Tout le monde n'importe où dans le contenu. Ces mots ne doivent pas être forcément affichés dans le même ordre.

2. entire:"Bonjour tout le monde"

Cette chaîne de recherche renvoie les e-mails qui contiennent exactement la phrase « Bonjour tout le monde » dans l'e-mail, telle qu'elle est rédigée à l'intérieur des guillemets. 

Critères de recherche supplémentaires :

Outre les termes de recherche ci-dessus, vous pouvez spécifier des critères de recherche supplémentaires comme des dossiers, des étiquettes, des pièces jointes, des drapeaux, des types d'e-mail, et la date/heure auxquelles l'e-mail a été envoyé.  

ParamètreValeurs autoriséesExemple
has

 Le paramètre has vous aide à filtrer davantage les résultats pour les e-mails. 

has:attachment - E-mails avec pièces jointes

has:flags - E-mails avec drapeaux

has:convo - E-mails qui font partie d'une conversation

in

Vous pouvez inclure ce paramètre pour effectuer une recherche dans un dossier spécifique. 

in:<non du dossier>

in:Marketing

où « Marketing » est le nom d'un dossier

label

Vous pouvez inclure ce paramètre pour rechercher des e-mails contenant une étiquette ou un tag spécifique. 

in:<nom de l'étiquette>

label:payroll

où « payroll » est le nom d'une étiquette

fromDate

toDate

Les paramètres fromDate et toDate vous aident à spécifier une plage de dates pour les e-mails. 

fromDate:DD-MMM-YYYY
toDate:DD-MMM-YYYY

fromDate:12-Sep-2017
toDate:30-Jun-2018

inclspamtrash

Intégrez ce paramètre si vous souhaitez inclure également les dossiers Spam et Corbeille dans les résultats de la recherche.
Si vous ne souhaitez pas inclure ces dossiers, ignorez ce paramètre dans votre recherche.

inclspamtrash:true

inclspamtrash:true

Opérateurs : 

Tout en incluant des paramètres multiples à la recherche, les différents paramètres peuvent être combinés à l'aide de l'opérateur :: et de l'opérateur OR.

Pour appliquer le texte ou la valeur de recherche à un paramètre, utilisez le signe « deux points » : :.

Par exemple, si vous souhaitez rechercher des e-mails contenant le terme « marketing », il faut mentionner entire:marketing.

Opérateur pour indiquer la condition suivante :

Si vous souhaitez mentionner une série de conditions dans une seule clé searchKey, vous devrez utiliser :: pour désigner la condition suivante.

Syntaxe : ::

Exemple : entire:paie::has:pièce jointe

Cette clé searchKey renvoie les e-mails contenant une pièce jointe et le terme « paie » dans une partie de l'e-mail.

Opérateur OR :

Syntaxe : :or:

Exemple - sender:frank@zylker.com::or:to:frank@zylker.com

Cette clé searchKey dresse la liste des e-mails qui sont envoyés ou reçus par frank@zylker.com.

Remarque :

Si aucun opérateur n'est mentionné après l'opérateur ::, l'opération AND sera effectuée par défaut.

Exemple de clé searchKey :

subject:Facture::sender:customercare@creditcard.com::has:pièce jointe

La valeur de la chaîne ci-dessus appliquée comme clé searchKey renvoie les e-mails dont l'objet contient le terme Facture, envoyés par customercare@creditcard.com et contenant des pièces jointes.

Share this post : FacebookTwitter

Vous ne trouvez toujours pas ce que vous cherchez?

Écrivez-nous: support@zohomail.com