Présentation de l'API Gmail

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

Termes courants

Voici une liste des termes courants utilisés dans cette API :

Délégant et délégué
Un délégant est un utilisateur Gmail qui accorde l'accès à sa boîte aux lettres à un autre utilisateur de la même organisation Google Workspace. L'utilisateur qui reçoit cet accès est le représentant. Les délégués peuvent lire, envoyer et supprimer des messages, ainsi qu'afficher et ajouter des contacts au nom du compte du délégant. Pour en savoir plus, consultez Gérer les délégués.
Draft
 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 la ressource drafts. Pour en savoir plus, consultez Utiliser des brouillons.
Filtres
Règles avancées configurées pour un compte qui évaluent les messages entrants en fonction de critères de correspondance spécifiques (comme l'expéditeur, l'objet ou la taille). Lorsqu'un message correspond, les filtres déclenchent automatiquement des actions telles que l'ajout ou la suppression de libellés, ou le transfert de l'e-mail vers une adresse spécifiée. Pour en savoir plus, consultez Gérer les filtres.
Adresses de transfert
 Adresses e-mail spécifiques et validées configurées pour recevoir les messages transférés automatiquement depuis le compte d'un utilisateur. Pour qu'une adresse puisse être utilisée dans une règle de transfert ou un filtre, elle doit être officiellement enregistrée et validée pour prouver qu'elle vous appartient. Pour en savoir plus, consultez Gérer le transfert.
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. Pour en savoir plus, consultez Gérer les libellés.

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 discussions, 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 la ressource labels.
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 la ressource messages.

Notifications push

Système de notification côté serveur s'intégrant à Google Cloud Pub/Sub. Les applications peuvent "surveiller" une boîte aux lettres, et l'API Gmail enverra des webhooks ou des alertes automatiques chaque fois qu'un changement se produit (par exemple, lorsqu'un nouvel e-mail arrive), ce qui évite à l'application d'interroger en permanence le serveur pour obtenir des mises à jour. Pour en savoir plus, consultez Notifications push.

Certificats S/MIME

Certificats numériques importés dans des alias "Envoyer sous" spécifiques, qui permettent à un utilisateur d'envoyer des e-mails chiffrés et signés numériquement, garantissant ainsi la sécurité des messages et l'authenticité de l'expéditeur. Pour en savoir plus, consultez Gérer les certificats S/MIME.

Alias "Envoyer en tant que"

Elles représentent les différentes adresses e-mail à partir desquelles un compte est autorisé à envoyer des e-mails. Chaque compte possède au moins un alias représentant l'adresse e-mail principale. Les alias correspondent à la fonctionnalité "Envoyer des e-mails en tant que" de l'interface Web Gmail. Ils servent également de base pour configurer des signatures d'e-mail par adresse. Pour en savoir plus, consultez Gérer les alias.

Thread

Ensemble de messages associés formant une conversation. Dans une application de client de messagerie, un fil de discussion est créé lorsqu'un ou plusieurs destinataires répondent à un message avec leur propre message. Pour en savoir plus, consultez Gérer les fils de discussion.

  • Pour en savoir plus sur le développement avec les API Google Workspace, y compris sur la gestion de l'authentification et des autorisations, consultez Développer sur Google Workspace.

  • Pour savoir comment configurer et exécuter une application de l'API Gmail, consultez les guides de démarrage rapide.