Intégration à Google Agenda

Grâce au connecteur d'action Google Calendar, vous pouvez accéder à Google Calendar directement dans Amazon Quick via le langage naturel. Vous pouvez créer et mettre à jour des événements, vérifier la disponibilité, gérer les calendriers et organiser les participants sans quitter Amazon Quick.

Amazon Quick prend en charge plusieurs méthodes d'authentification pour Google Calendar. Choisissez la méthode qui répond le mieux aux exigences de sécurité de votre entreprise.

• Application OAuth par défaut — Utilise une application OAuth AWS gérée. Aucune information d'identification supplémentaire n'est requise. Vous vous authentifiez directement avec votre compte Google.

• Application OAuth personnalisée : utilise un client OAuth géré par le client créé dans la console Google Cloud. Cette option donne à votre organisation le contrôle total de la configuration OAuth.

Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultezMéthodes d’authentification.

Avant de commencer

Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.

• Un compte Google avec accès à Google Agenda.

• Pour l'application OAuth personnalisée : accès à la console Google Cloud sur le site Web de Google avec les autorisations nécessaires pour créer des clients OAuth.

• Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultezConfiguration des intégrations dans la console.

Configuration de Google Cloud

Si vous utilisez l'authentification par défaut de l'application OAuth, ignorez cette section et passez à. Configuration du connecteur dans Amazon Quick

Pour l'authentification personnalisée de l'application OAuth, effectuez les étapes suivantes dans la console Google Cloud avant de configurer Amazon Quick. Lorsque vous activez l'API à l'étape 3, recherchez et activez l'API Google Agenda.

Création d'un client OAuth dans Google Cloud Console

Créez un client OAuth dans la console Google Cloud pour obtenir les informations d'identification client dont vous avez besoin pour Amazon Quick. Pour plus d'informations, consultez la section Utilisation d'OAuth 2.0 pour accéder aux API Google sur le site Web de Google.

1. Connectez-vous à la console Google Cloud sur le site Web de Google.

2. Créez un nouveau projet ou sélectionnez un projet existant.

3. Dans le volet de navigation de gauche, choisissez APIs & Services, puis Library. Recherchez l'API requise pour votre intégration et choisissez Activer.

4. Choisissez l'écran de consentement OAuth, puis choisissez Get Started.

5. Configurez l'écran de consentement :

   • Entrez un nom d'application et sélectionnez un e-mail d'assistance utilisateur.

   • Pour Audience, choisissez Interne (votre organisation uniquement) ou Externe (n'importe quel utilisateur de Google).

   • Ajoutez les coordonnées du développeur et choisissez Créer.

6. Choisissez Create OAuth client.

7. Configurez le client :

   • Pour Type d'application, sélectionnez Application Web.

   • Entrez le nom de votre client.

   • Sous URI de redirection autorisés, ajoutez l'URL de rappel Amazon Quick : https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

8. Choisissez Créer.

9. Enregistrez les valeurs suivantes. Vous en avez besoin lorsque vous configurez Amazon Quick.

   • Identifiant du client

   • Secret client

Éscopes recommandés

Les champs d'application suivants sont demandés lorsque vous vous connectez à Google Agenda.

Champs d'application recommandés par Google Agenda

Scope	Description
https://www.googleapis.com/auth/calendar	Lit et écrit les événements et les paramètres du calendrier.
openid	Authentifie l'identité de l'utilisateur.
email	Lit l'adresse e-mail de l'utilisateur.

Note

Les email étendues openid et sont automatiquement incluses dans le flux de consentement OAuth pour l'authentification des utilisateurs. Ils ne sont pas obligatoires pour Service-to-Service OAuth.

Configuration du connecteur dans Amazon Quick

Se connecter depuis l'onglet Disponible

Si vous souhaitez utiliser l'authentification par défaut de l'application OAuth, vous pouvez vous connecter directement depuis l'onglet Disponible sans configuration supplémentaire.

1. Dans la console Amazon Quick, choisissez Connectors.

2. Dans l'onglet Disponible, recherchez Google Agenda et choisissez Connect.

3. Complétez le flux de connexion à Google et accordez les autorisations demandées.

Pour configurer un connecteur avec l'application OAuth personnalisée à la place, utilisez l'onglet Créer pour votre équipe, comme décrit ci-dessous.

Créez à partir de l'onglet Créer pour votre équipe

Une fois que vous avez terminé toute configuration requise de Google Cloud, créez le connecteur dans Amazon Quick.

1. Dans la console Amazon Quick, choisissez Connectors.

2. Choisissez l'onglet Créer pour votre équipe.

3. Recherchez et choisissez Google Agenda.

   Note

   S'il existe déjà un connecteur Google Agenda, une boîte de dialogue contenant vos connecteurs existants s'affiche. Pour utiliser un connecteur existant, choisissez-le. Pour en créer un nouveau, choisissez Non, créer un nouveau.

4. Entrez un nom pour votre connecteur. Choisissez éventuellement + Ajouter une description pour ajouter une description.

5. Pour Type de connexion, sélectionnez Réseau public.

6. Pour la configuration OAuth, choisissez l'une des méthodes d'authentification suivantes et configurez les champs obligatoires.

   1. Pour l'application OAuth par défaut :

      Aucune information d'identification supplémentaire n'est requise. Choisissez Next (Suivant) pour continuer.

   2. Pour l'application OAuth personnalisée, configurez les champs suivants :

      • URL de base (facultatif) : URL de base de l'API Google Agenda. Exemple : https://www.googleapis.com/calendar

      • ID client : ID client de votre client Google Cloud OAuth.

      • Secret client : secret client de votre client Google Cloud OAuth.

      • URL du jeton : point de terminaison du jeton. Exemple : https://oauth2.googleapis.com/token

      • URL d'autorisation : point de terminaison d'autorisation. Exemple : https://accounts.google.com/o/oauth2/v2/auth

      • URL de redirection : Pre-filled avec l'URL de rappel Amazon Quick.

7. Choisissez Suivant.

8. Si vous avez choisi l'application OAuth par défaut ou l'application OAuth personnalisée, une fenêtre d'autorisation Google s'ouvre. Passez en revue les autorisations demandées et choisissez Autoriser.

9. Sur la page Révision, passez en revue les actions disponibles pour le connecteur. Choisissez Suivant.

10. Sur la page Publier, choisissez qui peut accéder au connecteur. Vous pouvez autoriser l'accès à tous les membres de votre organisation ou rechercher des équipes ou des groupes spécifiques.

11. Choisissez Publier.

Actions disponibles

Après avoir configuré le connecteur, les actions suivantes sont disponibles.

Actions disponibles dans Google Agenda

Catégorie	Action	Description
Événements	Liste des événements	Répertorie les événements sur un calendrier.
Événements	Rechercher des événements	Recherche des événements par mot clé ou par critère.
Événements	Obtenir un événement	Récupère les détails d'un événement spécifique.
Événements	Créer un événement	Crée un nouvel événement du calendrier.
Événements	Créer un événement rapide	Crée un événement à partir d'une chaîne de texte.
Événements	Evénement de mise à jour	Met à jour un événement existant.
Événements	Mettre à jour le calendrier des événements	Déplace un événement vers un autre calendrier.
Événements	Importer des événements	Importe des événements dans un calendrier.
Événements	Lister les instances d'événements	Répertorie les instances d'un événement récurrent.
Événements	Supprimer un participant	Supprime un participant d'un événement.
Disponibilité	Liste des machines à sous gratuites	Trouve les plages horaires disponibles dans les calendriers.
Calendriers	Lister les calendriers	Répertorie les calendriers de l'utilisateur authentifié.
Calendriers	Lister les événements du calendrier	Répertorie les événements de tous les calendriers.
Calendriers	Obtenir le calendrier	Récupère les détails d'un calendrier spécifique.
Calendriers	Obtenir la liste des calendriers	Récupère une entrée de liste de calendriers.
Calendriers	Mettre à jour la liste des calendriers	Met à jour une entrée de liste de calendriers.
Settings	Paramètres de la liste	Répertorie les paramètres du calendrier pour l'utilisateur.
Utilitaires	Obtenir la date et l'heure actuelles	Récupère la date et l'heure actuelles.

Note

Les actions que vous pouvez utiliser dépendent des calendriers accessibles à l'utilisateur authentifié.

Gestion et résolution des problèmes

Pour modifier, partager ou supprimer votre connecteur, consultezGestion des intégrations existantes.

Problèmes courants liés à l'authentification Google

• Sign-in échoue (application OAuth par défaut ou application OAuth personnalisée) : vérifiez que votre compte Google est actif et que vous pouvez vous connecter directement au site Web de Google. Pour l'application OAuth personnalisée, vérifiez que l'URI de redirection dans votre client Google Cloud OAuth correspond à l'URL de rappel Amazon Quick.

• Application bloquée par l'administrateur : si votre administrateur Google Workspace restreint l'accès aux applications tierces, un message d'erreur peut s'afficher lorsque vous tentez de vous connecter. Contactez votre administrateur Google Workspace pour autoriser l'application Amazon Quick.

• Informations d'identification client non valides (application OAuth personnalisée) : vérifiez que l'ID client et le secret du client correspondent aux valeurs de votre client Google Cloud OAuth.

• Échec de la fenêtre contextuelle d'authentification : vérifiez que votre navigateur autorise les fenêtres contextuelles provenant du domaine de la console Amazon Quick. Essayez d'utiliser un autre navigateur ou de vider le cache de votre navigateur.

• Autorisations révoquées — Si vous avez précédemment révoqué l'accès à Amazon Quick depuis les paramètres d'autorisation de votre compte Google, vous devez vous authentifier à nouveau en modifiant le connecteur et en vous reconnectant.

• Limitation du débit de l'API Google : Google peut limiter les demandes pendant les périodes de forte utilisation. Si les actions échouent, réessayez après quelques minutes.

Calendar-specific Problèmes liés à Google

• API Google Agenda non activée : vérifiez que l'API Google Calendar est activée dans votre projet Google Cloud sous API et services, Bibliothèque.