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
ouSPAM
. Vous ne pouvez ni supprimer ni modifier ces libellés. Toutefois, certains libellés système, tels queINBOX
, 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
Pour en savoir plus sur le développement avec les API Google Workspace, y compris sur la gestion de l'authentification et de l'autorisation, consultez Premiers pas en tant que développeur Google Workspace.
Pour apprendre à configurer et à exécuter une application simple de l'API Gmail, consultez la présentation des guides de démarrage rapide.