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 », soumises à un contrôle préalable de Google, ce qui influe sur la manière de configurer l’accès.

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

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, les agences immobilières, ainsi que les cabinets d’expertise comptable.

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 au nom de domaine de l’entreprise (l’adresse en @votre-entreprise.fr), à 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 02/11/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 » (scopes), accordées par le protocole d’autorisation OAuth, qui permet d’ouvrir un accès sans communiquer de mot de passe : 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 pour une application publique, c’est-à-dire ouverte à des utilisateurs extérieurs à l’entreprise, une vérification, complétée d’une évaluation de sécurité si les données sont stockées ou transmises par un serveur ; l’envoi seul est classé « sensible », non restreint
Usage interneAucune vérification pour une application déclarée « interne » sur l’écran de consentement OAuth (la page où l’utilisateur accepte l’accès), dans un projet, c’est-à-dire l’espace où l’application est déclarée, appartenant à l’organisation Google Workspace et réservée à ses utilisateurs
Quotas6 000 unités par minute et par utilisateur, chaque opération consommant un nombre fixe de ces unités de crédit ; l’envoi d’un message en consomme 100, sa lecture 20, ou 60 avec son contenu complet, la lecture de l’historique des changements 2
NotificationsAvis des changements d’une boîte transmis par Google Cloud Pub/Sub, le service de messagerie entre applications de Google, à raison d’un avis par seconde au plus ; la surveillance doit ê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, l’espace technique où Google enregistre ses applications, 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 pouvant néanmoins avoir à l’approuver. Hors de ce cas, Google dispense de vérification une application à usage personnel de moins de cent utilisateurs, qui affiche toutefois un avertissement à chaque connexion.

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

Opérations de l’API Gmail, documentation consultée le 02/11/2026 (extrait)
DonnéesLectureÉcriture
MessagesListe, contenu, pièces jointes, historique des changementsEnvoi, déplacement vers la corbeille, modification des libellés (les étiquettes de classement de Gmail)
BrouillonsListe et contenuCréation, modification, envoi
LibellésListeCréation, modification, suppression
Filtres et réglagesListeCréation de filtres, délégations d’accès à un collaborateur, 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, décompté 2 unités par appel.
  • 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 2 novembre 2026, que Google met à jour régulièrement.

Nodva conçoit des workflows, enchaînements d’étapes automatiques, et des agents IA, programmes d’intelligence artificielle qui lisent et rédigent, 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 ; un envoi automatique n’est mis en place qu’avec votre accord écrit. L’automatisation d’une tâche est proposée à partir de 1 200 €, celle qui fait intervenir un agent IA à partir de 3 000 € ; la supervision est facultative 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 : 100 unités pour l’envoi d’un message, 20 pour sa lecture, 60 si son contenu complet est demandé.

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.