Présentation de l'API Gmail

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 aux données Gmail d'un utilisateur avec autorisation. Elle convient à diverses applications, telles que :

  • Extraction, indexation et sauvegarde des e-mails en lecture seule
  • Envoi de messages automatisé ou par programmation
  • Migration des comptes de messagerie
  • Organisation des e-mails, y compris le filtrage et le tri des messages
  • Normalisation 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.
Brouillon
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 drafts ressource. Pour en savoir plus, consultez Utiliser des brouillons.
Filtres
Règles avancées configurées pour un compte qui évaluent les messages entrants par rapport à des critères de correspondance spécifiques (tels que 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 à partir du compte d'un utilisateur. Avant de pouvoir être utilisée dans une règle ou un filtre de transfert, une adresse doit être officiellement enregistrée et validée pour prouver qu'elle appartient à l'utilisateur. Pour en savoir plus, consultez Gérer le transfert.
Libellé

Mécanisme d'organisation des messages et des fils de discussion. Par exemple, le libellé "Impôts" 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. Ces libellés ne peuvent pas être supprimés ni modifiés. Toutefois, certains libellés système, tels que INBOX, 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 la labels ressource.
Message

E-mail contenant l'expéditeur, les destinataires, l'objet et le corps. Une fois créé, un message ne peut plus être modifié. Un message est représenté par la messages ressource.

Notifications push

Système de notification côté serveur qui s'intègre à 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), ce qui évite à l'application d'interroger en permanence le serveur pour obtenir des mises à jour. Pour en savoir plus, consultez Push notifications.

Certificats S/MIME

Certificats numériques importés dans des alias d'envoi 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 d'envoi

Ils 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 un e-mail en tant que" de l'interface Web Gmail et servent également de base pour configurer des signatures d'e-mail par adresse. Pour en savoir plus, consultez Gérer les alias.

Fil de discussion

Ensemble de messages associés formant une conversation. Dans une application cliente 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 d'API Gmail, consultez les guides de démarrage rapide.