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.
Intégration à Google Docs
Grâce au connecteur d'action Google Docs, vous pouvez accéder à Google Docs directement dans Amazon Quick via le langage naturel. Vous pouvez créer et modifier des documents, lire du contenu, insérer du texte et des images, et gérer la structure des documents sans quitter Amazon Quick.
Amazon Quick prend en charge plusieurs méthodes d'authentification pour Google Docs. 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 Docs.
-
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 Docs.
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
-
Connectez-vous à la console Google Cloud
sur le site Web de Google. -
Créez un nouveau projet ou sélectionnez un projet existant.
-
Dans le volet de navigation de gauche, choisissez APIs & Services, puis Library. Recherchez l'API requise pour votre intégration et choisissez Activer.
-
Choisissez l'écran de consentement OAuth, puis choisissez Get Started.
-
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.
-
-
Choisissez Create OAuth client.
-
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
-
-
Choisissez Créer.
-
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 Docs.
| Scope | Description |
|---|---|
https://www.googleapis.com/auth/documents |
Lit et écrit des documents Google Docs. |
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.
-
Dans la console Amazon Quick, choisissez Connectors.
-
Dans l'onglet Disponible, recherchez Google Docs et choisissez Connect.
-
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.
-
Dans la console Amazon Quick, choisissez Connectors.
-
Choisissez l'onglet Créer pour votre équipe.
-
Recherchez et choisissez Google Docs.
Note
Si un connecteur Google Docs existe déjà, 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.
-
Entrez un nom pour votre connecteur. Choisissez éventuellement + Ajouter une description pour ajouter une description.
-
Pour Type de connexion, sélectionnez Réseau public.
-
Pour la configuration OAuth, choisissez l'une des méthodes d'authentification suivantes et configurez les champs obligatoires.
-
Pour l'application OAuth par défaut :
Aucune information d'identification supplémentaire n'est requise. Choisissez Next (Suivant) pour continuer.
-
Pour l'application OAuth personnalisée, configurez les champs suivants :
-
URL de base (facultatif) — URL de base de l'API Google Docs. Par exemple :
https://docs.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.
-
-
-
Choisissez Suivant.
-
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.
-
Sur la page Révision, passez en revue les actions disponibles pour le connecteur. Choisissez Suivant.
-
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.
-
Choisissez Publier.
Actions disponibles
Après avoir configuré le connecteur, les actions suivantes sont disponibles.
| Catégorie | Action | Description |
|---|---|---|
| Documents | Obtenir le document | Récupère un document par identifiant. |
| Documents | Obtenir le texte en clair du document | Récupère le contenu en texte brut d'un document. |
| Documents | Rechercher des documents | Recherche des documents. |
| Documents | Créer un document | Crée un nouveau document. |
| Documents | Créer un document Markdown | Crée un nouveau document à partir du contenu Markdown. |
| Documents | Copier le document | Crée une copie d'un document existant. |
| Documents | Mettre à jour le document | Met à jour un document existant. |
| Documents | Mettre à jour le Markdown du document | Met à jour un document avec du contenu Markdown. |
| Documents | Section de mise à jour du document | Met à jour une section spécifique d'un document avec Markdown. |
| Documents | Mettre à jour le style du document | Met à jour le style d'un document. |
| Documents | Exporter un PDF | Exporte un document sous forme de fichier PDF. |
| Contenu | Insérer du texte | Insère du texte à un emplacement spécifié. |
| Contenu | Mettre à jour le texte | Remplace toutes les occurrences du texte spécifié. |
| Contenu | Supprimer la plage de contenu | Supprime le contenu dans une plage spécifiée. |
| Contenu | Insérer une image en ligne | Insère une image en ligne dans un document. |
| Contenu | Créer une table | Insère un tableau dans un document. |
| Contenu | Création de puces de paragraphe | Ajoute une mise en forme de bullet aux paragraphes. |
| Contenu | Créer une plage nommée | Crée une plage nommée dans un document. |
| Contenu | Créer un saut de page | Insère un saut de page. |
| Structure | Créer un en-tête | Crée un en-tête dans un document. |
| Structure | Créer un pied de page | Crée un pied de page dans un document. |
Note
Les actions que vous pouvez utiliser dépendent des documents 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.
Docs-specific Problèmes liés à Google
-
API Google Docs non activée : vérifiez que l'API Google Docs est activée dans votre projet Google Cloud sous API et services, Bibliothèque.
