Documentation · Services

Vos rendez-vous dans Google Agenda.

Chaque rendez-vous pris sur le site s'inscrit dans votre agenda Google ; et, si vous le voulez, vos événements Google ferment les créneaux du site qui les chevauchent. Comptez une dizaine de minutes la première fois.

Le principe

JEIKO se connecte à Google Agenda par un compte de service : un compte « robot » qui écrit dans votre agenda sans jamais connaître votre mot de passe. Vous le créez dans Google Cloud, vous lui partagez votre agenda, et vous donnez sa clé à JEIKO.

1 — Créer un projet Google Cloud

  1. Ouvrez console.cloud.google.com avec le compte Google qui possède l'agenda.
  2. Sélecteur de projet › Nouveau projet, nommez-le (« Agenda du site »), puis Créer.

2 — Activer l'API Google Calendar

Menu ☰ › API et services › Bibliothèque, cherchez Google Calendar API, puis Activer.

3 — Créer le compte de service et sa clé

  1. API et services › Identifiants › Créer des identifiants › Compte de service. Nommez-le (« jeiko-agenda »), puis Créer et continuer, puis OK : aucun rôle n'est nécessaire.
  2. Ouvrez ce compte › onglet Clés › Ajouter une clé › Créer une clé › JSON. Un fichier .json se télécharge.
  3. Notez l'adresse du compte de service, du type jeiko-agenda@votre-projet.iam.gserviceaccount.com.

Ce fichier contient une clé privée. Ne l'envoyez jamais par e-mail ou messagerie, et supprimez-le une fois collé dans JEIKO. En cas de doute, supprimez la clé dans Google Cloud et créez-en une nouvelle.

4 — Partager votre agenda avec le compte de service

  1. Dans Google Agenda, survolez l'agenda voulu › ⋮ › Paramètres et partage.
  2. Partager avec des personnes précises › Ajouter des personnes : collez l'adresse du compte de service, avec le droit Apporter des modifications aux événements.

5 — Récupérer l'ID de l'agenda

Toujours dans Paramètres et partage, section Intégrer l'agenda : copiez l'ID de l'agenda — votre adresse Gmail pour l'agenda principal, ou une valeur en @group.calendar.google.com pour un agenda secondaire.

6 — Le saisir dans JEIKO

  1. Administration › Rendez-vous › Connexion Google.
  2. Collez tout le contenu du fichier JSON (de l'accolade ouvrante à l'accolade fermante) et l'ID de l'agenda, puis enregistrez. La clé est chiffrée en base et n'est jamais réaffichée.
  3. Facultatif : cochez Bloquer mes créneaux quand mon agenda Google est occupé. Toutes les 30 minutes, vos événements des 90 prochains jours ferment les créneaux du site qui les chevauchent ; il faut alors que le partage de l'étape 4 donne accès aux détails des événements.
  4. Facultatif : le récapitulatif quotidien, chaque soir à l'heure choisie, des rendez-vous du lendemain.

En cas de problème

  1. Erreur 404 : l'ID de l'agenda est faux, ou l'agenda n'a pas été partagé (étape 4).
  2. Erreur 403 : l'API Calendar n'est pas activée (étape 2), ou le compte de service n'a que la lecture.
  3. Un compte de service ne peut pas inviter de participants sur un agenda Gmail personnel : le rendez-vous est créé sans invitation, et la confirmation part par e-mail depuis le site.

Tous les servicesGuide des rendez-vous