Intégration à Google Sheets

Grâce au connecteur d'action Google Sheets, vous pouvez accéder à Google Sheets directement dans Amazon Quick via le langage naturel. Vous pouvez créer et modifier des feuilles de calcul, lire et écrire des plages de cellules, formater des cellules et rechercher des données sans quitter Amazon Quick.

Amazon Quick prend en charge plusieurs méthodes d'authentification pour Google Sheets. 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 par OAuth. 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 Sheets.

• 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 consultez. 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 Sheets.

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 le nom de l'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 Sheets.

Champs d'application recommandés par Google Sheets

Scope	Description
https://www.googleapis.com/auth/spreadsheets	Lit et écrit des feuilles de calcul Google Sheets.
https://www.googleapis.com/auth/drive	Lit et écrit des fichiers dans Google Drive.
https://www.googleapis.com/auth/drive.readonly	Lit des fichiers dans Google Drive.
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 Sheets 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 Sheets.

   Note

   S'il existe déjà un connecteur Google Sheets, 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 Sheets. Par exemple : https://sheets.googleapis.com

      • 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. Par exemple : https://oauth2.googleapis.com/token

      • URL d'autorisation : point de terminaison d'autorisation. Par 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 Sheets

Catégorie	Action	Description
Valeurs	Obtenir des valeurs	Lit les valeurs d'une plage de cellules.
Valeurs	Batch Get Value	Lit les valeurs de plusieurs plages de cellules en une seule demande.
Valeurs	Obtenir des valeurs par filtre	Lit les valeurs à l'aide d'un filtre de données.
Valeurs	Mettre à jour les valeurs	Écrit des valeurs dans une plage de cellules.
Valeurs	Valeur de mise à jour par lots	Écrit des valeurs dans plusieurs plages de cellules en une seule demande.
Valeurs	Ajouter des valeurs	Ajoute des valeurs après la dernière ligne de données d'une plage.
Valeurs	Supprimer des valeurs	Efface les valeurs d'une plage de cellules.
Valeurs	Mettre à jour le texte	Recherche et remplace du texte dans une feuille de calcul.
Lignes	Créer une ligne	Crée une nouvelle ligne dans une feuille de calcul.
Lignes	Mettre des lignes	Insère des lignes dans une feuille de calcul.
Lignes	Obtenir une ligne de feuille de calcul	Recherche une ligne en fonction de critères correspondants.
Feuilles de calcul	Créer une feuille de calcul	Crée une nouvelle feuille de calcul.
Feuilles de calcul	Obtenir des informations sur les feuilles de calcul	Récupère les métadonnées d'une feuille de calcul.
Feuilles de calcul	Feuilles de calcul de recherche	Recherche des feuilles de calcul.
Feuilles	Créer une feuille	Ajoute une nouvelle feuille à une feuille de calcul.
Feuilles	Noms des feuilles de liste	Répertorie les noms des feuilles dans une feuille de calcul.
Feuilles	Mettre à jour les propriétés des feuilles	Met à jour les propriétés de la feuille telles que le nom ou la visibilité.
Mise en forme	Mettre à jour le format de cellule	Formate les cellules d'une plage.
Mise en forme	Mettre à jour les règles de format conditionnel	Crée ou met à jour les règles de mise en forme conditionnelle.

Note

Les actions que vous pouvez utiliser dépendent des feuilles de calcul 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.

Sheets-specific Problèmes liés à Google

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