Passer au contenu principal

Intégration Google Calendar - Guide de configuration

Connectez votre compte Google Calendar à Goodweek pour lire, créer et gérer des événements de calendrier et des plannings directement depuis votre espace de travail IA.

A
Écrit par Antoine Stempien

Connectez votre compte Google Calendar à Goodweek pour lire, créer et gérer des événements de calendrier et des plannings directement depuis votre espace de travail IA.

ℹ️ Note sur la gouvernance

Goodweek ne dépassera jamais les niveaux d'accès accordés à l'utilisateur au sein de Google Calendar, garantissant ainsi l'alignement avec les politiques de gouvernance de votre organisation. Les résultats et les fonctionnalités disponibles peuvent varier en fonction des autorisations spécifiques et de l'accès authentifié de chaque utilisateur.

📋 Prérequis

Avant qu'un utilisateur puisse voir et connecter l'intégration Google Calendar, l'administrateur de votre organisation doit d'abord l'activer depuis le Panneau d'administration Goodweek, dans l'onglet Intégrations.

Configuration administrateur

Comptes Google personnels (@gmail.com)

Aucune configuration administrateur n'est requise. Connectez-vous directement en suivant les étapes de Connexion de l'utilisateur ci-dessous.

Comptes Google Workspace (professionnel ou établissement scolaire)

Selon la politique d'accès aux API de votre organisation, l'un des scénarios suivants peut s'appliquer.

Scénario 1 — Par défaut (accès tiers non restreint)

Tout utilisateur peut se connecter directement sans intervention de l'administrateur.

Scénario 2 — L'accès tiers est restreint (erreur admin_policy_enforced)

Un Super Admin Google Workspace doit marquer Composio comme application de confiance :

  1. Connectez-vous à admin.google.com en tant que Super Admin.

  2. Accédez à Sécurité → Contrôle des accès et des données → Contrôles des API → Gérer l'accès des applications tierces.

  3. Cliquez sur Configure new app, recherchez Composio, sélectionnez-le, définissez l'accès sur Trusted, puis cliquez sur Save.

Scénario 3 — Tout accès tiers aux API est bloqué

Accédez à admin.google.com → Sécurité → Contrôle des accès et des données → Contrôles des API et vérifiez le paramètre "Third-party app access to Google APIs". S'il est bloqué, l'administrateur doit créer une exception pour Composio avant de suivre le Scénario 2.

Connexion de l'utilisateur

  1. Dans Goodweek, accédez à Intégrations.

  2. Recherchez Google Calendar et cliquez sur Connect.

  3. Vous serez redirigé vers Google, où il vous sera demandé de vous connecter.

  4. Vérifiez les autorisations demandées et cliquez sur Allow pour revenir à Goodweek.

Remarques importantes

  • Chaque utilisateur doit connecter son propre compte individuellement.

  • Goodweek ne peut accéder qu'aux calendriers auxquels votre compte utilisateur individuel a accès. Les calendriers partagés ne sont accessibles que si les autorisations de partage appropriées vous ont été accordées.

  • Si vous disposez de plusieurs comptes Google, veillez à sélectionner le bon lors de l'étape de connexion.

  • Vous pouvez révoquer l'accès de Goodweek à tout moment depuis myaccount.google.com → Sécurité → Applications tierces ayant accès au compte.


Outils disponibles

Outil

Description

Type

Create Event

Crée un nouvel événement dans un Google Calendar avec l'heure de début, la durée, les participants et d'autres détails.

Écriture

Update Event

Met à jour les champs d'un événement de calendrier existant à partir de son ID.

Écriture

Patch Event

Met à jour partiellement des champs spécifiques d'un événement de calendrier existant sans écraser le reste.

Écriture

Quick Add Event

Crée un événement de calendrier basique en analysant une chaîne de texte en langage naturel (par ex. « Déjeuner avec Alice demain à 13 h »).

Écriture

Get Event

Récupère un événement de calendrier unique à partir de son ID unique.

Lecture

Find Event

Recherche des événements dans un calendrier à l'aide d'une requête textuelle, de plages horaires et de types d'événements.

Lecture

List Events

Renvoie les événements d'un calendrier spécifié sur une plage horaire donnée.

Lecture

List Events from All Calendars

Renvoie une liste unifiée d'événements sur tous les calendriers de la liste de calendriers de l'utilisateur pour une plage horaire donnée.

Lecture

Get Event Instances

Renvoie toutes les occurrences d'un événement récurrent sur une plage horaire facultative.

Lecture

Find Free Slots

Trouve les créneaux libres et occupés dans les calendriers spécifiés sur une plage horaire définie.

Lecture

Get Current Date and Time

Renvoie la date et l'heure actuelles pour un fuseau horaire donné, utile avant de calculer des dates relatives.

Lecture

Create a New Calendar

Crée un nouveau Google Calendar secondaire avec un titre spécifié et des paramètres facultatifs.

Écriture

List Google Calendars

Récupère tous les calendriers de la liste Google Calendar de l'utilisateur.

Lecture

Patch Calendar

Met à jour partiellement les métadonnées d'un calendrier existant (nom, description, fuseau horaire, etc.).

Écriture

Move Event

Déplace un événement vers un autre calendrier.

Lecture

List Calendar Resources

Récupère les ressources de calendrier telles que les salles de réunion d'un domaine Google Workspace.

Lecture

Create ACL Rule

Crée une règle de contrôle d'accès pour accorder des autorisations de partage de calendrier à un utilisateur, un groupe ou un domaine.

Écriture

List ACL Rules

Récupère toutes les règles de contrôle d'accès d'un calendrier spécifié.

Lecture

Delete Event

Supprime définitivement un événement de calendrier spécifié à partir de son ID.

⚠️ Destructif

Remove Attendee from Event

Supprime un participant spécifique d'un événement de calendrier existant.

⚠️ Destructif

Delete Calendar

Supprime définitivement un calendrier secondaire appartenant à l'utilisateur.

⚠️ Destructif

Clear Calendar

Supprime tous les événements d'un calendrier principal tout en conservant le calendrier lui-même.

⚠️ Destructif

Delete ACL Rule

Supprime une autorisation de partage d'un Google Calendar.

⚠️ Destructif

Cas d'usage

  • Créez et gérez des événements depuis vos conversations. Planifiez des réunions, définissez des rappels ou ajoutez des événements à votre Google Calendar directement depuis une conversation Goodweek — y compris les participants, le lieu et la description — sans passer par l'application de calendrier.

  • Vérifiez les disponibilités avant de planifier. Interrogez les créneaux libres et occupés d'un ou plusieurs calendriers pour trouver un horaire de réunion adapté avant de le proposer aux participants.

  • Consultez votre agenda à tout moment. Récupérez les événements du jour, de la semaine ou de toute plage horaire personnalisée sur l'ensemble de vos calendriers pour obtenir un aperçu rapide de votre emploi du temps sans quitter votre espace de travail.

  • Mettez à jour ou annulez des événements rapidement. Modifiez les détails d'un événement ou supprimez des participants de réunions existantes directement depuis Goodweek en cas de changement de plans, sans naviguer dans l'interface du calendrier.


Dépannage

"Error 400: admin_policy_enforced" lors de la connexion

L'administrateur de votre organisation a restreint l'accès des applications tierces. Seul un Super Admin Google Workspace peut résoudre ce problème en suivant le Scénario 2 ci-dessus.

L'administrateur a marqué Composio comme Trusted mais l'erreur persiste

Il peut y avoir un délai de propagation. Patientez quelques minutes et réessayez.

Intégration non visible dans Goodweek

Assurez-vous que l'administrateur de votre organisation a activé l'intégration Google Calendar depuis le Panneau d'administration Goodweek, dans l'onglet Intégrations.

Références

Avez-vous trouvé la réponse à votre question ?