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 syntaxe de recherche avancée que l'interface Web de Gmail. Pour obtenir la liste des différences de recherche et de filtre entre l'UI Gmail et l'API Gmail, consultez la section Différences entre les filtres de recherche et 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 le libellé, pour nommer plusieurs options. 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 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 avec les libellés système ou utilisateur spécifiés. Pour en savoir plus, consultez la documentation de référence sur la méthode messages.list
ou threads.list
.
Différences entre les recherches et les filtres dans l'interface utilisateur de Gmail et dans l'API Gmail
L'UI Gmail effectue l'extension d'alias, ce qui lui permet d'inférer un alias de compte à partir d'un compte Google Workspace. Par exemple, supposons que vous ayez un compte
myprimary@mycompany.net
et que votre administrateur configure un alias pour ce comptemyalias@mycompany.net
. Simyalias@mycompany.net
envoie un e-mail, mais que vous recherchez "from: myprimary@mycompany.net)
", l'e-mail envoyé parmyalias@mycompany.net
s'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, contrairement à l'API.