Authentification Google Docs

Prérequis

Selon le type d'authentification que vous sélectionnez, vous avez besoin de l'une des informations d'identification suivantes :

• Code d'autorisation OAuth 2.0 : votre adresse e-mail Google et le mot de passe associé à votre compte Google.
• Fournissez votre propre application OAuth 2.0 : l' ID client et la clé secrète du client, ainsi que les étendues.
• Compte de service : clé de compte de service, e-mail de compte.

Si votre compte n'est pas activé par Google :

• Contactez votre administrateur pour obtenir l'approbation de la création de connexions.
• Activez l'autorisation en cochant les options disponibles pour autoriser la création d'une connexion.

Remarque :

For more details regarding the different authentication types, refer to the How to connect to Google Workspace 365 activities guide.

Pour plus d'informations sur Google Docs, reportez-vous à la documentation pour les développeurs Google Docs.

Étendues

Le connecteur demande les autorisations/étendues suivantes :

• Étendues par défaut de l’application publique UiPath : openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, https://mail.google.com/, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/gmail.settings.basic.
• Étendues par défaut du compte de service : openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, https://mail.google.com/, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/gmail.settings.basic.
• Apportez votre propre application OAuth 2.0 :
  • Étendues minimales pour créer une connexion : openid, https://www.googleapis.com/auth/drive.readonly.
  • Liste minimale des étendues requises pour les déclencheurs Google Docs :
    • openid, https://www.googleapis.com/auth/drive.readonly

Remarque : si vous vous authentifiez à l'aide de l'application Apporter votre propre application OAuth 2.0 (Bring your Own OAuth 2.0), vous bénéficiez par défaut des étendues configurées lors de la création de l'application. Si vous souhaitez utiliser les autorisations d'application par défaut, vous pouvez déclarer une étendue common . Cela signifie que vous utilisez uniquement les autorisations configurées pour cette application. Vous pouvez également déclarer des étendues supplémentaires lors de la création de la connexion, à l'aide du champ Étendues ( Scopes ). Il vous sera alors demandé d’accorder le consentement supplémentaire lors de la connexion.

La connexion permet aux produits UiPath d'interagir avec les données Google Docs à votre place. Cela peut inclure la lecture, l'écriture, la modification et la suppression de données, en fonction de vos autorisations Google Docs. Vous pouvez toujours supprimer les accès à votre compte Google.

Ajouter la connexion Google Docs

1. Sélectionnez Integration Service à partir d' Automation Cloud^TM.

2. Dans la liste Connecteurs , sélectionnez Google Docs. Vous pouvez également utiliser la barre de recherche pour trouver le connecteur.

3. Sélectionnez le bouton Ajouter une connexion (Add connection).

4. Vous êtes maintenant redirigé vers la page de connexion. Sélectionnez le type d'authentification préféré

   If you select Bring your own OAuth 2.0 app, you must provide a Client ID and Client secret, and the Scopes you may need to interact with different activities. Check out the activities' documentation to learn what scopes they require.

5. Votre connexion a été ajoutée.

Actualiser les jetons pour les applications OAuth

Google has refresh token limitations for individual OAuth 2.0 client IDs. If the limit is reached, creating a new refresh token automatically invalidates the oldest refresh token without warning. This limit does not apply to service accounts (refer to Using OAuth 2.0 for Server-to-Server Applications). For more information, refer to Google's official documentation.

Une liste des raisons qui peuvent entraîner l'expiration du jeton :

• Vous avez révoqué l’accès de votre application.
• Le jeton de réactualisation n'a pas été utilisé depuis six mois.
• Vous devez modifier les mots de passe et le jeton d'actualisation contient des étendues Gmail.
• Votre compte a dépassé le nombre maximum de jetons de réactualisation (en direct) accordés.
  • Si vous demandez un nouveau jeton après que la limite est dépassée, votre ancienne connexion, basée sur un jeton précédemment accordé, expirera. Seule la nouvelle connexion ou la dernière connexion modifiée/réauthentifiée (avec le dernier jeton) fonctionnera.
• Un administrateur a défini l'un des services demandés dans les étendues de votre application sur Restreint (L'erreur est admin_policy_enforced).
• Pour les API Google Cloud Platform: la longueur de session définie par l'administrateur aurait pu être dépassée.

Remarque : La limite est actuellement fixée à 100 jetons de réactualisation par compte Google par ID de client OAuth 2.0. Ce numéro peut être soumis à des modifications. Pour obtenir les dernières informations, vérifiez toujours la documentation Google.

Il existe une limite plus importante sur le nombre total de jetons de réactualisation qu'un compte d'utilisateur ou un compte de service peut avoir pour tous les clients. Les utilisateurs réguliers ne dépasseront pas cette limite, contrairement à un compte développeur utilisé pour tester une implémentation.

To make sure this limit is not exceeded, UiPath offers users the ability to create their own OAuth applications and connect using the Bring your own app authentication type. Make sure to follow the best practices from Google when creating your OAuth application. For details on how to create an OAuth application, refer to Google's official documentation.

Avertissement : l'invalidation du jeton entraîne des connexions échouées et les automatisations ne peuvent pas s'exécuter sans que les connexions soient corrigées.