Recherche de messages

Vous pouvez rechercher ou filtrer des fichiers à l'aide des méthodes messages.list et threads.list. Ces méthodes acceptent le paramètre q, qui est compatible avec la plupart de la même syntaxe de recherche avancée que l'interface Web de Gmail. Pour obtenir la liste des différences de recherche et de filtrage entre l'interface utilisateur de Gmail et l'API Gmail, consultez la section Différences entre les filtres de recherche: interface utilisateur Gmail et API Gmail.

Cette syntaxe avancée vous permet d'utiliser des requêtes de recherche pour filtrer les messages en fonction de propriétés telles que l'expéditeur, la date ou le libellé, et ce pour plusieurs exemples. Par exemple, la requête suivante récupère tous les messages envoyés par l'utilisateur en janvier 2014:

GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01

Avertissement :Toutes les dates utilisées dans la requête de recherche sont interprétées comme minuit à cette date dans le fuseau horaire PST. Pour spécifier des dates précises pour d'autres fuseaux horaires, transmettez la valeur en secondes à la place :

?q=in:sent after:1388552400 before:1391230800

En plus des requêtes de recherche, vous pouvez également filtrer les messages et les fils de discussion par libellé à l'aide du paramètre labelIds. Cela vous permet de rechercher des messages et des fils de discussion auxquels sont appliqués les libellés système ou utilisateur spécifiés. Pour en savoir plus, consultez la documentation de référence des méthodes messages.list ou threads.list.

Différences de recherche et de filtrage: interface utilisateur de Gmail par rapport à l'API Gmail

• L'interface utilisateur de Gmail effectue l'extension d'alias, ce qui lui permet de déduire un alias de compte à partir d'un compte Google Workspace. Par exemple, supposons que vous ayez un compte [e-mail] et que votre administrateur configure un alias pour ce compte [e-mail]. Si [e-mail] envoie un e-mail, mais que vous recherchez "from: [e-mail])", l'e-mail envoyé par [e-mail] s'affiche en tant que résultat de recherche dans l'interface utilisateur de Gmail, mais pas dans la réponse de l'API.

• L'interface utilisateur de Gmail permet aux utilisateurs d'effectuer des recherches à l'échelle d'un fil de discussion, contrairement à l'API.