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 des syntaxes de recherche avancée de l'interface Web Gmail. Pour obtenir la liste des différences entre la recherche et les filtres dans l'UI Gmail et l'API Gmail, consultez Différences entre la recherche et les filtres: UI Gmail par rapport à l'API Gmail.
Cette syntaxe avancée vous permet d'utiliser des requêtes de recherche pour filtrer les messages par propriétés, telles que l'expéditeur, la date ou l'étiquette, pour n'en citer que quelques-unes. 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
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. Vous pouvez ainsi rechercher des messages et des fils de discussion auxquels les libellés système ou utilisateur spécifiés sont appliqués. Pour en savoir plus, consultez la référence des méthodes messages.list ou threads.list.
Différences entre la recherche et le filtrage dans l'UI Gmail et l'API Gmail
L'UI Gmail effectue une expansion d'alias, ce qui lui permet d'inférer un alias de compte à partir d'un compte Google Workspace. Par exemple, supposons que vous possédiez un compte
myprimary@mycompany.netet que votre administrateur configure un alias pour ce compte,myalias@mycompany.net. Simyalias@mycompany.netenvoie un e-mail, mais que vous recherchez "from: myprimary@mycompany.net)", l'e-mail envoyé parmyalias@mycompany.nets'affiche comme 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 du fil de discussion, mais l'API ne le permet pas.