Pour que l’assistant puisse lire les e-mails dans Google Workspace et y créer des brouillons, il a besoin d’un accès via la Gmail API. Pour cela, l’organisation crée ce qu’il faut dans son propre Google Cloud ; draften n’a pas d’application commune à laquelle il vous suffirait de donner votre consentement. Cela vaut pour notre service comme pour une installation sur votre propre serveur.
Tout ce qui suit ne vaut que pour les comptes Google Workspace avec votre propre domaine. Un compte personnel @gmail.com ne permet pas de se connecter à draften ; un Gmail personnel peut toutefois être connecté via IMAP avec un mot de passe d’application – voir Fournisseurs pris en charge et limites.
Ce que vous voulez et ce qu’il faut configurer
| Ce que vous voulez | Ce qu’il faut configurer |
|---|---|
| Les membres se connectent avec leur compte Google et chacun a sa propre boîte mail | le client de l’organisation – cela suffit |
| En plus, des boîtes mail auxquelles personne ne se connecte (par exemple info@), ou un accès aux boîtes mail configuré de façon centralisée, sans leurs propriétaires | en plus, l’inscription de l’organisation (compte de service) |
| Vous ne voulez pas de connexion avec un compte Google | les membres se connectent avec le mot de passe défini via l’invitation ; les e-mails sont connectés par l’inscription de l’organisation (ou IMAP) |
Deux choses distinctes chez Google
Le client de l’organisation et l’inscription de l’organisation sont deux choses distinctes dans Google Cloud. Chacune a son propre rôle, et l’une ne remplace pas l’autre :
| Client de l’organisation | Inscription de l’organisation | |
|---|---|---|
| Ce que c’est | un client OAuth avec un écran de consentement de type Internal | un compte de service avec une clé et domain-wide delegation |
| Rôle | la connexion des membres avec le bouton Se connecter avec Google et le bouton Connecter Gmail sur leur propre boîte mail | l’accès de l’assistant aux boîtes mail sans que leurs propriétaires se connectent |
| Où dans draften | Organisation → Connexion et accès aux e-mails → carte Connexion des comptes et des boîtes mail | Organisation → Connexion et accès aux e-mails → carte Inscriptions pour les boîtes mail partagées et la gestion centrale |
| Qui s’en charge dans draften | le propriétaire de l’organisation | le propriétaire ou un gestionnaire de l’organisation |
| Qui le crée chez Google | un administrateur Google Cloud | un administrateur Google Cloud et un super-administrateur Google Admin |
| Qui se connecte à la boîte mail | le propriétaire de chaque boîte mail, une fois | personne |
| Boîtes mail atteintes | uniquement celles que les membres connectent eux-mêmes | toutes les boîtes mail du domaine |
Ce sont délibérément deux choses. Le consentement au client ne donne des droits que sur les boîtes mail que les membres connectent eux-mêmes – jamais sur les e-mails de tout le domaine. Le compte de service, lui, atteint chaque boîte mail du domaine ; c’est pourquoi draften ne l’utilise que pour l’accès aux boîtes mail, jamais pour la connexion. Ne les fusionnez pas.
Chaque boîte mail utilise l’un des deux accès ; vous pouvez avoir les deux en même temps. draften ne demande que le champ d’application gmail.modify – lire et créer des brouillons ; il n’envoie rien.
Client de l’organisation : connexion et Connecter Gmail
Le propriétaire de la boîte mail se connecte avec son compte Google et n’autorise l’accès qu’à ses propres e-mails. Le même client sert aussi à la connexion à draften avec un compte Google.
Dans Google Cloud
Vous travaillez dans https://console.cloud.google.com, connecté avec un compte d’administrateur de votre domaine Workspace. Tout se passe dans un seul projet – le projet sélectionné est affiché en haut à gauche, à côté du logo Google Cloud ; c’est aussi là que vous en changez ou que vous en créez un nouveau. Le menu principal s’ouvre avec l’icône ☰ en haut à gauche.
- Dans draften, ouvrez d’abord Organisation → Connexion et accès aux e-mails, carte Connexion des comptes et des boîtes mail. Elle affiche deux Redirect URIs établies exactement pour votre adresse draften – elles se terminent par
/auth/google/callbacket/mailboxes/connect/google/callback. Copiez-les depuis cette carte ; elles doivent correspondre caractère pour caractère. - Choisissez un projet ou créez-en un nouveau (par exemple
draften), et activez-y la Gmail API : ☰ → APIs & Services → Library, recherchez Gmail API, ouvrez-la et cliquez sur Enable. Lien direct : https://console.cloud.google.com/apis/library/gmail.googleapis.com - Définissez comment l’application se présente aux utilisateurs (écran de consentement) : ☰ → APIs & Services → OAuth consent screen. La page Google Auth Platform s’ouvre ; lien direct : https://console.cloud.google.com/auth/overview (vérifiez que le bon projet est sélectionné en haut). Cliquez sur Get started et suivez les étapes :
- App Information – App name
draftenet User support email (votre adresse e-mail ou un groupe d’administrateurs). Next. - Audience – choisissez Internal. Seul un compte de votre domaine Workspace peut alors se connecter, et Google n’a pas besoin de valider l’application. Next.
- Contact Information – l’adresse e-mail à laquelle Google vous envoie les notifications concernant l’application. Next.
- Finish – cochez la case d’acceptation des règles de Google (I agree to the Google API Services: User Data Policy), cliquez sur Continue puis sur Create.
- App Information – App name
- Autorisez les champs d’application pour l’application. Dans Google Auth Platform, ouvrez Data Access dans le menu de gauche (lien direct : https://console.cloud.google.com/auth/scopes) → Add or remove scopes. Dans la liste, cochez
openid,.../auth/userinfo.emailet.../auth/userinfo.profile. Collez le champ d’application pour Gmail dans la zone Manually add scopes :https://www.googleapis.com/auth/gmail.modify→ Add to table. Cliquez sur Update puis, en bas, sur Save. - Créez le client. Dans Google Auth Platform, ouvrez Clients dans le menu de gauche (lien direct : https://console.cloud.google.com/auth/clients) → Create client. Application type : Web application, un nom, par exemple
draften. Sous Authorized redirect URIs, cliquez sur Add URI et collez la première adresse de la carte, puis de nouveau Add URI et la deuxième. Cliquez sur Create. - Le Client ID et le Client secret s’affichent – copiez-les tout de suite tous les deux. Google n’affichera plus le Client secret par la suite ; si vous le perdez, créez-en un nouveau au niveau du client.
Dans draften
- Le propriétaire de l’organisation ouvre Organisation → Connexion et accès aux e-mails et renseigne, dans la carte Connexion des comptes et des boîtes mail, sous Client OAuth Google, les valeurs Client ID et Client secret de l’étape 6, puis clique sur Enregistrer.
- Il active la connexion avec un compte Google sur la même page, dans la carte Comment les membres se connectent : dans Domaines e-mail de l’organisation, il saisit le domaine Workspace – le domaine principal, pas un domaine d’alias (Google ne l’envoie pas lors de la connexion). Dès que l’organisation a le client et le domaine, les membres se connectent avec leur compte Google et leurs mots de passe cessent de fonctionner – voir Comment les membres se connectent.
- Le propriétaire de la boîte mail ouvre la page de la boîte mail et, dans la carte Accès aux e-mails, sur la ligne Connecter avec le compte de la boîte mail :, clique sur Connecter Gmail. Il se connecte avec le compte de cette boîte mail – draften refuse tout autre compte – et autorise l’accès. Le bouton n’est visible que pour le propriétaire de la boîte mail, et seulement si l’organisation a le client ; sans lui, la carte indique à la place du bouton que la connexion avec un compte sera possible dès que le propriétaire de l’organisation aura ajouté le client.
- Puis Tester la connexion.
Quand une boîte mail se déconnecte
- Le compte a été supprimé ou bloqué, ou l’accès révoqué – Google cesse d’émettre des jetons et draften déconnecte la boîte mail. Reconnectez-la (Reconnecter Gmail) ou passez par l’inscription de l’organisation (ci-dessous).
- « Le fournisseur n’a émis aucun jeton d’actualisation » – le propriétaire de la boîte mail supprime l’application dans les paramètres de son compte Google (Sécurité → Applications et services tiers) et reconnecte la boîte mail.
- « Un autre compte que celui de l’adresse de la boîte mail s’est connecté » – lors de la connexion, choisissez le compte de cette boîte mail précisément.
Inscription de l’organisation : accès sans connexion
Un compte de service avec domain-wide delegation donne à l’assistant l’accès aux boîtes mail du domaine sans que personne ne se connecte. Il convient aux boîtes mail auxquelles personne ne se connecte (par exemple info@) et aux organisations qui veulent gérer l’accès de façon centralisée. Il n’a rien à voir avec la connexion à draften.
Dans Google Cloud
Vous travaillez dans https://console.cloud.google.com, dans le même projet où la Gmail API est activée (étape 2 du client de l’organisation ; sans client, activez-la de la même façon). Vérifiez le projet en haut à gauche, à côté du logo Google Cloud.
- Ouvrez la liste des comptes de service : ☰ → IAM & Admin → Service accounts. Lien direct : https://console.cloud.google.com/iam-admin/serviceaccounts
- En haut, cliquez sur + Create service account et suivez les trois étapes :
- Service account details – Service account name, par exemple
draften-emails(l’ID se remplit tout seul). Cliquez sur Create and continue. - Permissions (optional) – ne choisissez rien ; il n’a besoin d’aucun rôle dans le projet, c’est la délégation dans Google Admin qui lui donne accès aux e-mails. Cliquez sur Continue.
- Principals with access (optional) – ne remplissez rien, cliquez sur Done.
- Service account details – Service account name, par exemple
- Dans la liste, cliquez sur le nouveau compte de service. Dans l’onglet Details, copiez l’Unique ID – un long nombre ; c’est le Client ID pour Google Admin.
- Onglet Keys → Add key → Create new key → Key type : JSON → Create. Le navigateur télécharge un fichier contenant la clé (
….json).
Si Google refuse de créer la clé, votre organisation a activé la règle Disable service account key creation (iam.disableServiceAccountKeyCreation ; les nouvelles organisations l’ont par défaut). Un administrateur de l’organisation la désactive pour ce projet : ☰ → IAM & Admin → Organization policies (https://console.cloud.google.com/iam-admin/orgpolicies), recherche iam.disableServiceAccountKeyCreation → Manage policy → Override parent's policy → Enforcement : Off → Set policy. Répétez ensuite l’étape 4.
Dans Google Admin
Il vous faut un compte de super-administrateur Google Workspace.
- Ouvrez https://admin.google.com → dans le menu de gauche Security → Access and data control → API controls → en bas Domain wide delegation → Manage domain wide delegation. Lien direct : https://admin.google.com/ac/owl/domainwidedelegation
- Cliquez sur Add new et remplissez :
- Client ID – l’Unique ID numérique de l’étape 3,
- OAuth scopes (comma-delimited) –
https://www.googleapis.com/auth/gmail.modify.
Cliquez sur Authorize. La délégation apparaît dans la liste. Elle prend effet en général en quelques minutes, exceptionnellement au bout de plusieurs heures.
Dans draften
- Ouvrez Organisation → Connexion et accès aux e-mails, carte Inscriptions pour les boîtes mail partagées et la gestion centrale. Les inscriptions sont gérées par le propriétaire ou les gestionnaires de l’organisation.
- Système : Google Workspace. Remplissez Nom, choisissez le fichier téléchargé sous Clé du compte de service (JSON) et cliquez sur Ajouter une inscription. La clé est stockée chiffrée ; la carte n’affiche ensuite que l’e-mail du compte de service et son Client ID.
- Sur la page de chaque boîte mail, dans la carte Accès aux e-mails, choisissez cette inscription sous Inscription de l’organisation, cliquez sur Appliquer puis sur Tester la connexion. Le guide Ajouter et connecter une boîte mail montre la marche à suivre avec des captures d’écran.
Supprimez ensuite le fichier de clé téléchargé. Quiconque le possède accède à toutes les boîtes mail du domaine. Vous importez une nouvelle clé du même compte de service (étape 4 ci-dessus) au niveau de l’inscription avec nouvelle clé (JSON) ; ajoutez la clé d’un autre compte de service comme nouvelle inscription. Supprimez alors l’ancienne clé dans Google Cloud : compte de service → onglet Keys → icône de corbeille à côté de l’ancienne clé.
Avec la Boîte mail automatique activée (Comment les membres se connectent), une nouvelle boîte mail est liée d’elle-même à l’inscription lorsqu’il y en a exactement une active pour Google Workspace.
Erreurs du test de connexion
Le test vérifie trois étapes : Accès, Jeton et autorisation et Lecture de la boîte de réception.
| Dans le message | Ce que cela signifie | Que faire |
|---|---|---|
délégation non autorisée pour le champ d’application (unauthorized_client) | la domain-wide delegation manque dans Google Admin, ou elle a un autre Client ID ou un autre champ d’application | vérifier la délégation dans Google Admin : l’ID numérique et le champ d’application exact gmail.modify |
invalid_grant pour un compte de service | cette boîte mail n’existe pas dans le domaine Workspace | vérifier l’adresse de la boîte mail |
| « Gmail API has not been used… » | la Gmail API n’est pas activée dans le projet | activer la Gmail API |
jeton sans gmail.modify | la délégation ou l’écran de consentement n’a pas le champ d’application gmail.modify | ajouter le champ d’application |
invalid_grant, deleted_client pour un compte connecté | la connexion a été révoquée ou le client supprimé | Reconnecter Gmail |
Les autres erreurs sont décrites dans Résolution des problèmes.