Présentation de l'API Gmail
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Gmail est une API RESTful qui permet d'accéder aux boîtes aux lettres Gmail et d'envoyer des e-mails. Pour la plupart des applications Web, l'API Gmail est le meilleur choix pour accéder de manière autorisée aux données Gmail d'un utilisateur. Elle convient à diverses applications, telles que :
- Extraction, indexation et sauvegarde des e-mails en lecture seule
- Envoi de messages automatisé ou programmatique
- Migration de compte de messagerie
- Organisation des e-mails, y compris le filtrage et le tri des messages
- Standardisation des signatures d'e-mail dans une organisation
Vous trouverez ci-dessous une liste des termes courants utilisés dans l'API Gmail :
- Message
- Message électronique contenant l'expéditeur, les destinataires, l'objet et le corps. Une fois un message créé, il ne peut plus être modifié. Un message est représenté par une ressource de message.
- Thread
- Collection de messages associés formant une conversation. Dans une application de messagerie, un fil de discussion est créé lorsqu'un ou plusieurs destinataires répondent à un message avec leur propre message.
- Label
Mécanisme permettant d'organiser les messages et les fils de discussion. Par exemple, le libellé "Taxes" peut être créé et appliqué à tous les messages et fils de discussion concernant les impôts d'un utilisateur. Il existe deux types de libellés :
- Libellés système
- Libellés créés en interne, tels que
INBOX, TRASH ou SPAM. Vous ne pouvez ni supprimer ni modifier ces libellés. Toutefois, certains libellés système, tels que INBOX, peuvent être appliqués à des messages et des fils de discussion, ou en être supprimés.
- Libellés d'utilisateur
- Libellés créés par un utilisateur. Ces libellés peuvent être supprimés ou modifiés par l'utilisateur ou une application. Un libellé utilisateur est représenté par une ressource de libellé.
- Draft
Un message non envoyé. Un message contenu dans le brouillon peut être remplacé.
L'envoi d'un brouillon le supprime automatiquement et crée un message avec le libellé système SENT. Un brouillon est représenté par une ressource de brouillon.
Étapes suivantes
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/08/04 (UTC).
[null,null,["Dernière mise à jour le 2025/08/04 (UTC)."],[],[],null,["The Gmail API is a RESTful API that can be used to access Gmail mailboxes and\nsend mail. For most web applications the Gmail API is the best choice for\nauthorized access to a user's Gmail data and is suitable for various\napplications, such as:\n\n- Read-only mail extraction, indexing, and backup\n- Automated or programmatic message sending\n- Email account migration\n- Email organization including filtering and sorting of messages\n- Standardization of email signatures across an organization\n\nFollowing is a list of common terms used in the Gmail API:\n\n*Message*\n: An email message containing the sender, recipients, subject, and body. After a\n message has been created, a message cannot be changed. A message is represented\n by a [message resource](/workspace/gmail/api/reference/rest/v1/users.messages#Message).\n\n*Thread*\n: A collection of related messages forming a conversation. In an email client\n app, a thread is formed when one or more recipients respond to a message with\n their own message.\n\n*Label*\n\n: A mechanism for organizing messages and threads. For example,\n the label \"taxes\" might be created and applied to all messages and threads\n having to do with a user's taxes. There are two types of labels:\n\n *System labels*\n : Internally-created labels, such as `INBOX`, `TRASH`, or `SPAM`. These labels\n cannot be deleted or modified. However, some system labels, such as `INBOX`\n can be applied to, or removed from, messages and threads.\n\n *User labels*\n : Labels created by a user. These labels can be deleted or modified by the\n user or an application. A user label is represented by a\n [label resource](/workspace/gmail/api/reference/rest/v1/users.labels).\n\n*Draft*\n\n: An unsent message. A message contained within the draft can be replaced.\n Sending a draft automatically deletes the draft and creates a message with\n the `SENT` system label. A draft is represented by a\n [draft resource](/workspace/gmail/api/reference/rest/v1/users.drafts).\n\nNext steps\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer\n to [Get started as a Google Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Gmail API app, read the\n [Quickstarts overview](/workspace/gmail/api/guides/quickstarts-overview)."]]
