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 :

Pour plus de détails concernant les différents types d'authentification, consultez le guide des activités Comment se connecter à Google Workspace 365 .

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é

   Si vous sélectionnez Apporter votre propre application OAuth 2.0, vous devez fournir un ID de client et une clé secrète de client, ainsi que les étendues dont vous devrez peut-être interagir avec différentes activités. Consultez la documentation relative aux activités pour connaître les étendues requises.

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

Actualiser les jetons pour les applications OAuth

Google a mis à jour les limitations de jeton pour les ID de client OAuth 2.0 individuels. Si la limite est atteinte, la création d'un nouveau jeton de réactualisation invalide automatiquement le plus ancien jeton de réactualisation sans avertissement. Cette limite ne s'applique pas aux comptes de service (voir Utilisation d'OAuth 2.0 pour les applications de serveur à serveur). Pour plus d'informations, consultez la documentation officielle de Google.

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.

Pour s'assurer que cette limite n'est pas dépassée, UiPath offre aux utilisateurs la possibilité de créer leurs propres applications OAuth et de se connecter à l'aide du type d'authentification Fournissez votre propre application (Bring your Own App). Assurez-vous de suivre les bonnes pratiques de Google lors de la création de votre application OAuth. Pour plus de détails sur la création d'une application OAuth, consultez la documentation officielle de Google .

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.