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 parameter:<search value>.
| Paramètres | Description |
| entire | Renvoie les résultats qui contiennent le mot indiqué n'importe où dans l'e-mail. |
| content | Effectue l'opération de recherche pour la valeur donnée uniquement dans le contenu de 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. |
| fileContent | Renvoie 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ètre | Valeurs autorisées | Exemple |
| 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:<folder name> | 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:<label name> | 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 | fromDate:12-Sep-2017 |
| inclspamtrash | Intégrez ce paramètre si vous souhaitez inclure également les dossiers Spam et Corbeille dans les résultats de la recherche. inclspamtrash:true | inclspamtrash:true |
groupResult | Incluez ce paramètre si vous souhaitez regrouper les résultats de la recherche qui font partie de la même conversation. Par défaut, cette valeur est définie sur False. Définissez la valeur du paramètre sur True si vous souhaitez regrouper les e-mails. | groupResult: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.