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 ne citer que quelques 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
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 les libellés système ou utilisateur spécifiés sont appliqués. Pour en savoir plus, consultez la documentation de référence sur les méthodes messages.list ou threads.list.
Différences entre la recherche et le filtrage dans l'UI Gmail et dans l'API Gmail
L'interface utilisateur Gmail effectue une expansion 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 myprimary@mycompany.net et que votre administrateur configure un alias myalias@mycompany.net pour ce compte. Si myalias@mycompany.net envoie un e-mail, mais que vous recherchez "from: myprimary@mycompany.net)", l'e-mail envoyé par myalias@mycompany.net s'affiche dans les résultats de recherche de l'UI Gmail, mais pas dans la réponse de l'API.
L'UI Gmail permet aux utilisateurs d'effectuer des recherches dans l'ensemble des fils de discussion, mais l'API ne le permet pas.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/31 (UTC).
[null,null,["Dernière mise à jour le 2025/07/31 (UTC)."],[],[],null,["# Searching for Messages\n\nYou can search or filter files using the\n[`messages.list`](/workspace/gmail/api/v1/reference/users/messages/list) and\n[`threads.list`](/workspace/gmail/api/v1/reference/users/threads/list) methods.\nThese methods accept the `q` parameter which supports most of the same\n[advanced search syntax](https://support.google.com/mail/answer/7190) as\nthe Gmail web-interface. For a list of search and filter differences between\nthe Gmail UI and Gmail API, see\n[Search filter differences: Gmail UI versus Gmail API](#differences).\n\nThis advanced syntax allows you to use search queries\nto filter messages by properties such as the sender, date, or label to name a\nfew possibilities. For example, the following query retrieves all messages sent\nby the user in January of 2014: \n\n GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01\n\n| **Warning:** All dates used in the search query are interpreted as midnight on that date in the PST timezone. To specify accurate dates for other timezones pass the value in seconds instead: \n|\n| ```\n| ?q=in:sent after:1388552400 before:1391230800\n| ```\n\nIn addition to search queries, you can also filter messages and threads by label\nwith the `labelIds` parameter. This allows you to search for messages and\nthreads with the specified system or user labels applied. For more information,\nsee the [`messages.list`](/workspace/gmail/api/v1/reference/users/messages/list) or\n[`threads.list`](/workspace/gmail/api/v1/reference/users/threads/list) method reference.\n\nSearch and filter differences: Gmail UI versus Gmail API\n--------------------------------------------------------\n\n- The Gmail UI performs *alias expansion* which allows it to infer an\n account alias from a Google Workspace account. For example, suppose you have an\n account\n of `myprimary@mycompany.net` and your admin sets up an alias for that account of\n `myalias@mycompany.net`. If `myalias@mycompany.net` sends an email, but you\n search for \"`from: myprimary@mycompany.net)`\" the email sent by\n `myalias@mycompany.net` shows up as a search result the Gmail UI, but not in\n the API response.\n\n- The Gmail UI allows users to perform thread-wide searches, but the API\n doesn't."]]
