Brancher Google Agenda sur Accueil IA a pris quelques heures de code. Le faire accepter par Google demande un autre travail, que j'ai sous-estimé au départ : un écran de consentement complet, une justification écrite par scope, une politique de confidentialité qui nomme les données Google, et une vidéo de démonstration qui suit des règles précises.
J'ai tout consigné dans deux documents du dépôt, vérifiés contre le code et contre la production. En voici l'essentiel, avec l'autre produit concerné, Ecrivia, dont la situation est nettement plus difficile.
Trois niveaux de scopes, trois niveaux de peine
Google classe les autorisations en trois catégories, et c'est la première chose à regarder avant d'écrire une ligne.
- Non sensibles :
openid,email,profile. C'est ce qu'utilise « Continuer avec Google ». Aucune revue approfondie : la connexion fonctionne sans attendre. - Sensibles :
calendar.eventsetcalendar.freebusypour Accueil IA. Revue obligatoire, avec vidéo, et un délai annoncé de plusieurs jours à quelques semaines. - Restreints : c'est le cas d'Ecrivia, qui lit, classe et envoie des emails avec
gmail.readonly,gmail.modifyetgmail.send. Ils imposent, en plus de la vérification Google, une évaluation de sécurité CASA de niveau 2, qui se compte en mois.
D'où une règle simple : demander le scope le plus étroit qui fait le travail. L'agent vocal doit savoir si un créneau est libre, pas lire le titre des rendez-vous du client. Il demande donc calendar.freebusy, qui ne renvoie que des plages occupées. Le scope complet calendar est reconnu par le code s'il a déjà été accordé, mais jamais demandé :
const SCOPE_EVENTS = 'https://www.googleapis.com/auth/calendar.events';
const SCOPE_FULL = 'https://www.googleapis.com/auth/calendar';
/** Lecture des plages occupées, sans lire le contenu des événements. */
const SCOPE_FREEBUSY = 'https://www.googleapis.com/auth/calendar.freebusy';
const REQUESTED_SCOPES = [SCOPE_EVENTS, SCOPE_FREEBUSY, 'openid', 'email'];Ecrivia applique le même principe pour sa propre connexion : le « Continuer avec Google » réutilise le même client OAuth, mais avec openid email seulement. Il échappe ainsi à la vérification qui bloque l'accès à Gmail.
La console doit dire exactement ce que le code envoie
La plupart des refus et des pannes viennent d'un écart entre ce qui est déclaré dans la console et ce que l'application envoie réellement. J'ai donc vérifié chaque valeur en production plutôt que de la recopier depuis la configuration : la route de connexion répond par une redirection vers Google, et j'ai relevé dans cette URL le redirect_uri, les scopes et code_challenge_method=S256. C'est cette chaîne-là qu'on colle dans la console.
Les pièges que j'ai notés :
- Les URI de redirection sont comparées au caractère près.
localhostet l'adresse de bouclage numérique ne sont pas interchangeables pour Google, qui répondredirect_uri_mismatch. J'en déclare quatre : connexion et agenda, en production et sur le poste de développement. - Le domaine doit être vérifié dans la Search Console avec le même compte Google que le projet Cloud, sinon le domaine autorisé est refusé.
- L'accueil, la politique de confidentialité et les CGU doivent répondre en HTTPS sur le domaine autorisé au moment de la revue. La politique doit nommer les scopes, distinguer lecture et écriture, et citer la règle Limited Use de Google.
Un dernier détail, de code celui-là. Sans prompt=consent, un utilisateur qui a déjà consenti une fois ne reçoit pas de nouveau jeton de rafraîchissement : la reconnexion « réussit », puis l'agenda tombe à la première expiration. Le code refuse donc une connexion sans jeton de rafraîchissement plutôt que de créer une connexion condamnée.
Une justification par scope, en anglais
La revue est anglophone. Chaque scope sensible reçoit un paragraphe qui dit quand il sert, ce qui est lu et ce qui ne l'est jamais. Pour freebusy, par exemple : lecture des seules plages occupées de l'agenda principal, au moment où un créneau est proposé pendant un appel, sans lire titres, descriptions ni participants, et sans stocker le résultat. Pour calendar.events : l'agent ne modifie que les événements qu'il a lui-même créés, l'agenda interne d'Accueil IA fait foi, et quand un appel est supprimé ou anonymisé, l'identité de l'appelant est aussi retirée de l'événement recopié chez Google.
La vidéo, là où l'on se fait recaler
Google demande une vidéo YouTube non répertoriée qui montre le parcours réel. J'ai écrit un storyboard de neuf plans : la page d'accueil, la connexion Google, le consentement, le tableau de bord, la connexion de l'agenda et son second consentement, l'agenda Google avant, la création d'un rendez-vous, l'agenda Google après rafraîchissement, puis la déconnexion. Le plan « avant/après » est celui qu'on oublie, et c'est le plus coûteux : sans preuve d'écriture réelle, il faut tout retourner.
J'ai voulu automatiser le tournage avec Playwright, et j'ai dû en accepter les limites.
- Le script ne franchit jamais un écran de consentement. Filmer un consentement automatisé est un motif de rejet, et Google refuse souvent un navigateur piloté sur cet écran. Quatre plans sur neuf sont donc humains : le script affiche la consigne, laisse l'enregistrement tourner et attend Entrée. Sans terminal interactif, il saute ces arrêts et la vidéo n'est qu'une répétition.
- L'enregistrement vidéo de Playwright ne capture pas la barre d'adresse, alors que Google exige de voir le domaine. Le livrable est donc une capture d'écran système de la fenêtre entière ; le fichier de Playwright sert de repère de montage.
- Le bandeau de sous-titres n'est injecté que sur mes pages, jamais sur celles de Google : retoucher un écran de consentement fait recaler la vidéo.
async function sousTitre(page, texte) {
if (!page.url().startsWith(BASE)) return;
// ... bandeau fixe en bas de page : intitulé du plan + URL courante
}Les autres consignes tiennent en une ligne chacune : 1280×720 au minimum, deux à trois minutes, pauses bornées entre 1,5 et 2,5 secondes pour que le relecteur suive, aucune coupe à l'intérieur d'un consentement, une organisation de test plutôt qu'un vrai client.
En attendant la validation
Tant que l'application est en mode « Testing », elle est limitée à 100 utilisateurs de test ajoutés à la main, et le jeton de rafraîchissement expire au bout de sept jours. Une connexion d'agenda de test retombe donc chaque semaine en état « à reconnecter ». Ce n'est pas un bug, et mieux vaut le savoir avant d'en chercher un.
Côté Ecrivia, une alternative existe dans le produit : une connexion IMAP avec un mot de passe d'application, qui ne dépend pas de la revue Google.
Ce que j'en retiens
- Le choix des scopes est une décision produit. Passer d'un scope restreint à un scope sensible, ou de sensible à non sensible, change le calendrier de lancement de plusieurs mois.
- On relève la configuration en production, on ne la recopie pas. L'URL de redirection réelle est la seule source fiable.
- La vidéo est un livrable à part entière. Storyboard, preuve d'écriture avant/après et barre d'adresse visible se préparent avant de lancer l'enregistrement.
- On automatise la mise en scène, jamais le consentement.
Une intégration Google ou Microsoft à faire valider, et pas envie de découvrir les règles au troisième refus ? Parlons-en.