Compatibilité

Gmail et Google Workspace : les données qu’une automatisation peut relier par l’API Gmail

L’essentiel

Une boîte Gmail, qu’elle soit personnelle ou rattachée à Google Workspace, se relie à une automatisation par l’API Gmail, c’est-à-dire l’interface que Google met à la disposition des autres logiciels et dont il publie la documentation. Cette interface permet de lire et de classer les messages, de rédiger des brouillons, d’envoyer des courriels, ou encore d’être averti des changements survenus dans une boîte. Google classe toutefois les autorisations les plus étendues parmi les autorisations « restreintes », ce qui influe sur la manière de configurer l’accès.

Rédigé avec l’aide de l’intelligence artificielle et publié le 14 octobre 2026 sous la responsabilité de , fondateur de Nodva ; sources vérifiées le même jour.

Ce logiciel est employé dans chacun des métiers auxquels nous consacrons une page : les cabinets de courtage en assurance, les organismes de formation et CFA, ainsi que les agences immobilières.

Que recouvrent Gmail et Google Workspace ?

Gmail, la messagerie de Google, est le plus souvent utilisée par les entreprises dans le cadre de Google Workspace, qui associe la messagerie à son propre nom de domaine, à un agenda, à un espace de stockage de fichiers et à une console d’administration. Une automatisation accède à la messagerie par l’API Gmail, et aux autres services par leurs interfaces respectives.

Dans de nombreuses petites entreprises, les demandes des clients parviennent d’abord par la messagerie. Relier Gmail à une automatisation permet de traiter ces demandes sans ressaisie, à condition de régler avec soin les autorisations accordées.

De quel accès une automatisation dispose-t-elle ?

Modalités relevées le 14/10/2026 dans la documentation Google for Developers et le centre d’aide Google Cloud
ÉlémentCe que publie Google
Type d’accèsAPI Gmail, documentée publiquement
AutorisationsAutorisations distinctes, dites « périmètres » : envoi seul, informations d’en-tête seules (métadonnées), lecture, modification, brouillons
Périmètres restreintsLecture, modification, brouillons et métadonnées des messages, qui exigent une vérification de l’application, complétée d’une évaluation de sécurité si les données sont stockées ou transmises par un serveur
Usage interneAucune vérification obligatoire pour une application configurée comme interne et réservée aux utilisateurs de l’organisation Google Workspace
Quotas6 000 unités par minute et par utilisateur ; l’envoi d’un message en consomme 100, sa lecture 20
NotificationsAvis des changements d’une boîte transmis par le service Google Cloud Pub/Sub, la surveillance devant être renouvelée au moins tous les 7 jours

Cette règle des périmètres restreints appelle une attention particulière. Pour une entreprise sous Google Workspace, la voie la plus directe consiste à créer l’application dans le projet Google Cloud de l’entreprise, puis à la déclarer interne. Elle n’est alors utilisable que par les comptes de l’organisation et échappe à toute procédure de vérification. Un administrateur peut néanmoins avoir à l’approuver.

Quelles données peuvent être lues ou enregistrées ?

Opérations de l’API Gmail, documentation consultée le 14/10/2026 (extrait)
DonnéesLectureÉcriture
MessagesListe, contenu, pièces jointes, historique des changementsEnvoi, déplacement vers la corbeille, modification des libellés
BrouillonsListe et contenuCréation, modification, envoi
LibellésListeCréation, modification, suppression
Filtres et réglagesListeCréation de filtres, délégations, transferts

Une automatisation peut ainsi attribuer un libellé à une demande d’après son contenu et ouvrir le dossier correspondant dans le logiciel métier, enregistrer les pièces jointes d’un client dans le dossier qui leur revient, ou rédiger un brouillon de réponse qu’un collaborateur relit avant de l’envoyer. La rédaction de brouillons offre d’ailleurs un moyen simple de conserver la validation humaine sans changer d’outil.

Quelles limites faut-il connaître, et quels points vérifier ?

Une automatisation reliée à Gmail doit tenir compte de plusieurs contraintes fixées par Google :

  • Le quota de 6 000 unités par minute et par utilisateur, qu’une automatisation qui relit chaque message à chaque passage atteint bien plus vite qu’une automatisation qui ne lit que l’historique des changements.
  • Le renouvellement de la surveillance de la boîte, que Google recommande d’effectuer chaque jour et qui doit intervenir au plus tard tous les 7 jours.
  • Le cas des comptes Gmail personnels, pour lesquels une application interne n’est pas envisageable, puisqu’elle suppose une organisation Google Workspace.
  • La politique de Google relative aux données des utilisateurs, qui s’applique à toute application, vérifiée ou non.

Que vaut-il mieux confier à Gmail lui‑même ?

Trois traitements courants relèvent des réglages de Gmail et n’appellent aucune automatisation :

  • Le classement par expéditeur, par objet ou par mot-clé, que les filtres de Gmail réalisent sans développement.
  • Les réponses types aux demandes récurrentes, disponibles dans la messagerie.
  • Le transfert automatique vers une autre adresse, que l’utilisateur ou l’administrateur peut régler lui‑même.

Une automatisation devient utile lorsque le traitement suppose de comprendre le message, de le rapprocher d’un dossier tenu dans un autre outil ou d’enchaîner plusieurs actions. Lorsque la règle tient en une phrase, en revanche, un filtre Gmail suffit bien souvent.

Les précautions à prendre avant un projet avec Gmail

Les accès accordés à une automatisation reliée à Gmail doivent rester limités et pouvoir être retirés sans difficulté ; trois règles y contribuent :

  • Ne demandez que les autorisations nécessaires, l’envoi seul ne requérant pas la lecture des messages.
  • Sous Google Workspace, créez l’application dans le projet Google Cloud de l’entreprise plutôt que dans celui du prestataire.
  • Conservez la liste des autorisations accordées, afin de pouvoir les révoquer depuis la console d’administration au terme de la prestation.

Aucun partenariat

Nodva n’est ni partenaire ni revendeur de Google. Les noms Gmail et Google Workspace ne sont cités que pour indiquer la compatibilité d’un service avec ces outils (code de la propriété intellectuelle, article L713-6). Les informations de cette page proviennent de la documentation publique de Google, consultée le 14 octobre 2026, et sont susceptibles d’évoluer.

Nodva conçoit des workflows et des agents IA reliés à votre messagerie ainsi qu’à vos autres logiciels. Par défaut, tout envoi destiné à l’extérieur est soumis à la validation de vos équipes, et un envoi automatique n’est mis en place qu’avec votre accord écrit. L’automatisation d’une tâche reliée à un ou deux logiciels coûte de 1 200 à 1 800 €, celle qui fait intervenir un agent IA de 3 000 à 5 500 €, et le diagnostic de 30 minutes qui précède tout projet est gratuit.

Questions reçues

Questions fréquentes

Gmail dispose-t-il d’une API ?

Oui. Google documente publiquement l’API Gmail, qui permet de lire les messages, de gérer les libellés comme les brouillons, d’envoyer des courriels ou encore de recevoir des avis de changement. L’accès suppose une autorisation accordée par le titulaire de la boîte.

L’application doit-elle être vérifiée par Google ?

Pas nécessairement. La lecture des messages et la rédaction de brouillons relèvent de périmètres que Google classe comme restreints et soumet à vérification. Une application déclarée interne, réservée aux utilisateurs d’une organisation Google Workspace, en est toutefois dispensée.

Quelle est la limite d’utilisation de l’API Gmail ?

Google fixe la limite à 6 000 unités par minute et par utilisateur, ainsi qu’à 1 200 000 unités par minute pour l’ensemble d’un projet. Chaque opération a un coût propre, l’envoi d’un message représentant 100 unités et sa lecture 20.

Comment une automatisation est-elle avertie de l’arrivée d’un courriel dans Gmail ?

Par une surveillance de la boîte : Gmail publie chaque changement dans le service Google Cloud Pub/Sub, qui en avertit l’automatisation. Cette surveillance doit être renouvelée au moins tous les 7 jours, Google recommandant un renouvellement quotidien.