View a markdown version of this page

Connecteur d'action Google Drive - Amazon Quick
Avant de commencerConfiguration de Google CloudConfiguration du connecteur dans Amazon QuickActions disponiblesGestion et résolution des problèmes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Connecteur d'action Google Drive

Grâce au connecteur d'action Google Drive, vous pouvez accéder à Google Drive directement dans Amazon Quick via le langage naturel. Vous pouvez charger et télécharger des fichiers, gérer des dossiers, rechercher du contenu et suivre les modifications sans quitter Amazon Quick.

Amazon Quick prend en charge plusieurs méthodes d'authentification pour le connecteur d'action Google Drive. 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 Drive.

  • 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 Drive.

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 et 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 Drive.

Champs d'application recommandés par Google Drive
Scope Description
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.
https://www.googleapis.com/auth/drive.metadata.readonly Lit les métadonnées 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 Drive 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

Après avoir effectué 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 Drive.

    Note

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

      • 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. Vérifiez 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 sur Google Drive
Catégorie Action Description
Fichiers Obtenir le fichier Télécharge un fichier depuis Google Drive.
Fichiers Rechercher des fichiers Recherche des fichiers par nom ou par contenu.
Fichiers Obtenir les métadonnées des fichiers Récupère les métadonnées d'un fichier.
Fichiers Importer un fichier Télécharge un fichier sur Google Drive.
Fichiers Télécharger le fichier depuis l'URL Télécharge un fichier à partir d'une URL.
Fichiers Créer un fichier Crée un nouveau fichier.
Fichiers Créer un fichier à partir du texte Crée un fichier à partir du contenu du texte.
Fichiers Mettre un fichier Remplace le contenu d'un fichier existant.
Fichiers Mettre à jour le contenu du fichier Modifie le contenu d'un fichier existant.
Fichiers Mettre à jour l'emplacement du fichier Déplace un fichier vers un autre dossier.
Fichiers Copier le fichier Crée une copie d'un fichier.
Fichiers Exporter le fichier Exporte un fichier Google Workspace dans un autre format.
Fichiers Supprimer le fichier Déplace un fichier vers la corbeille.
Dossiers Create Folder Crée un nouveau dossier.
Dossiers Dossiers de recherche Recherche des dossiers par nom.
Permissions Autorisations de liste Répertorie les autorisations associées à un fichier ou à un dossier.
Commentaires Commentaires sur la liste Répertorie les commentaires sur un fichier.
Modifications Modifications de la liste Répertorie les modifications récentes apportées aux fichiers.
Modifications Jeton de page de démarrage Get Changes Récupère un jeton de page de démarrage pour suivre les modifications.
Conduire Obtenir des informations sur le lecteur Récupère des informations sur le Drive de l'utilisateur.
Note

Les actions que vous pouvez utiliser dépendent des fichiers et des dossiers 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.

Drive-specific Problèmes liés à Google

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