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 constitue le meilleur choix pour un accès autorisé aux données Gmail d'un utilisateur et convient à diverses applications, telles que:
- Extraction, indexation et sauvegarde des messages en lecture seule
- Envoi automatisé ou programmatique de messages
- Migration de compte de messagerie
- Organisation de la messagerie, y compris filtrage et tri des messages
- Standardisation des signatures électroniques dans une organisation
Voici une liste des termes courants utilisés dans l'API Gmail:
- Message
- Un e-mail 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
- Ensemble de messages associés formant une conversation. Dans une application cliente de messagerie, un fil de discussion est formé lorsqu'un ou plusieurs destinataires répondent à un message avec leur propre message.
- Libellé
Mécanisme d'organisation des messages et des fils de discussion. Par exemple, le libellé "taxes" peut être créé et appliqué à tous les messages et fils de discussion liés aux taxes 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
Ces libellés ne peuvent pas être supprimés ni modifiés. Cependant, certains libellés système, tels queINBOX
, peuvent être appliqués ou supprimés des messages et des fils de discussion. - 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é d'utilisateur est représenté par une ressource d'étiquette.
- Brouillon
Message non envoyé. Un message contenu dans le brouillon peut être remplacé. L'envoi d'un brouillon supprime automatiquement le brouillon et crée un message avec le libellé système
SENT
. Un brouillon est représenté par une ressource brouillon.
Étapes suivantes
Pour en savoir plus sur le développement avec les API Google Workspace, y compris la gestion de l'authentification et de l'autorisation, consultez Premiers pas en tant que développeur Google Workspace.
Pour savoir comment configurer et exécuter une application simple d'API Gmail, consultez la présentation des guides de démarrage rapide.