L'API Gmail est une API RESTful qui peut être utilisée pour accéder aux boîtes aux lettres Gmail et 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,TRASHouSPAM. 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 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.