Présentation de l'API Gmail

L'API Gmail est une API RESTful qui vous 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 délégué. 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é. Vous pouvez remplacer le message contenu dans le brouillon. L'envoi d'un brouillon le supprime automatiquement et crée un message avec le libellé système SENT. La ressource drafts représente un brouillon. 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. Avant de pouvoir utiliser une adresse dans une règle de transfert ou un filtre, vous devez l'enregistrer et la valider pour prouver que vous en êtes le propriétaire. Pour en savoir plus, consultez Gérer le transfert.
Label

Mécanisme permettant d'organiser les messages et les fils de discussion. Par exemple, vous pouvez créer le libellé "taxes" et l'appliquer à tous les messages et fils de discussion liés aux taxes. 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 pas supprimer ni modifier ces libellés. Toutefois, vous pouvez appliquer ou supprimer certains libellés système, comme INBOX, aux messages et aux fils de discussion.
Libellés utilisateur
Libellés créés par un utilisateur. Un utilisateur ou une application peuvent supprimer ou modifier ces libellés. La ressource labels représente un libellé utilisateur.
Message

E-mail contenant l'expéditeur, les destinataires, l'objet et le corps. Une fois que vous avez créé un message, vous ne pouvez plus le modifier. La ressource messages représente un message.

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 envoie des webhooks ou des alertes automatiques chaque fois qu'un changement se produit (par exemple, lorsqu'un nouvel e-mail arrive). Votre application n'a donc plus besoin d'interroger 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 en tant que" spécifiques. Ces certificats vous permettent d'envoyer des e-mails chiffrés et signés numériquement, ce qui garantit 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 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 un client de messagerie, un fil de discussion se forme 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 à l'aide de l'API Gmail, consultez les guides de démarrage rapide.