GSuite Application Scope

UiPath.GSuite.Activities.GSuiteApplicationScope

Description

Gère le client de connexion et l'authentification pour les activités Google Workspace. Les activités Google Workspace fonctionnent avec le compte indiqué dans l'étendue de l'application. Plusieurs types d'authentification sont disponibles.

À partir de la version 2.5.5, vous pouvez utiliser les nouvelles activités Google Workspace dans l’activité Étendue (Scope). Pour savoir comment utiliser les activités Integration Service avec l’étendue de l’application Google Workspace, consultez Comment utiliser les activités Google Workspace sans Integration Service.

Problème connu

Important :

Le type d’authentification OAuthClientID utilisant le client OAuth UiPath (l’application publique UiPath) dans l’étendue Google Workspace est actuellement indisponible. Les automatisations utilisant l’application publique UiPath pour s’authentifier peuvent cesser de fonctionner et générer le message d’erreur suivant : « Cette application est bloquée » (This app is blocked). Nous nous efforçons de résoudre le problème et de restaurer l’application.

Jusqu’à ce que nous restaurions l’application publique, vous pouvez utiliser l’authentification OAuthClientID avec une application Google personnalisée créée par votre organisation. Pour passer de l’application Google publique UiPath à une application Google personnalisée, procédez comme suit :

1. Créez votre propre application Google Cloud, attribuez les étendues nécessaires et créez les informations d’identification de l’ID client OAuth, comme expliqué dans Configurer des applications dans Google Cloud.
   • L’application publique UiPath utilise les étendues suivantes : https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/spreadsheets, https://www.googleapis.com/auth/documents, https://www.googleapis.com/auth/drive, https://mail.google.com. Vous pouvez utiliser les mêmes étendues ou en attribuer des personnalisées, en fonction de vos besoins.
2. Si vous sélectionnez le type d’authentification OAuthClientID, définissez le champ Client OAuth (OAuth Client) sur Personnalisé (Custom). Dans les champs ID de client (Client ID) et Clé secrète du client (Client Secret), ajoutez les informations d’identification de votre application personnalisée.
   
   

   

   
   
3. Testez votre automatisation, republiez le projet et exécutez-le.

Compatibilité du projet

Windows - Héritage | Windows

Configuration

• Méthode de connexion (Connection method) : sélectionnez la méthode de connexion que vous souhaitez utiliser. Les options disponibles dans le menu déroulant sont les suivantes :
  • Panneau Propriétés (Properties) : configurez les détails de connexion dans le panneau Propriétés (Properties).
  • Ressource : utilise les ressources d’identification Orchestrator. Nous vous recommandons d'utiliser cette option.

Méthode de connexion de ressource

Lorsque vous sélectionnez cette option, les champs d'authentification affichés dans l'option Panneau de propriétés (Properties Panel) sont masqués, car toutes les informations d'authentification sont stockées à l'intérieur de la ressource.

La méthode par ressource prend en charge les mêmes types d'authentification que la méthode du panneau de propriétés : ID de client OAuth, clé API ou clé de compte de service.

• Ressources de connexion ( Connection assets ) : parcourez les dossiers Orchestrator pour sélectionner une ressource. Ce champ prend en charge les variables IResource . Sélectionnez le bouton Gérer les ressources (Manage Assets ) pour ouvrir Orchestrator. La liste des ressources disponibles dépend de l'Orchestrator auquel votre Studio et votre Robot sont connectés.
  • Utilisez le bouton Plus pour sélectionner Recharger les ressources ( Reload Assets ) si vous avez mis à jour vos ressources dans Orchestrator. Notez que si vous ajoutez une nouvelle ressource dans Orchestrator alors que vous utilisez Studio Desktop, elle ne sera pas immédiatement disponible dans l’activité Étendue (Scope).

Commun

• DélaiAttenteMillisecondes : si cette option est définie, l’activité expirera avec une exception après le nombre défini de millisecondes.

Options

• Emplacement du magasin de données de connexion - Une liste déroulante qui spécifie où la réponse du jeton est stockée. Les valeurs de propriété disponibles sont Disque local, Orchestrator ou Ne jamais stocker.

  • Disque local : les jetons de connexion sont stockés dans un dossier local sur la machine. La même connexion peut être utilisée dans plusieurs processus sur la même machine.
  • Orchestrator - Les jetons de connexion sont stockés dans Orchestrator en tant que ressources dans un dossier spécifié. La même connexion peut être utilisée dans plusieurs processus sur plusieurs machines tant qu'elle a accès au dossier Orchestrator spécifié.
  • Ne jamais stocker (Neiver store) : les jetons de connexion ne sont jamais stockés.
• Chemin du dossier Orchestrator de connexion ( Connection Orchestrator Folder Path ) : le dossier Orchestrator dans lequel les opérations sont effectuées. Laissez ce champ vide si les dossiers modernes ne sont pas activés. Pour plus d'informations, consultez À propos des dossiers dans le guide Orchestrator.

Service Account Key

• E- mail de l'utilisateur - Si vous avez accordé l'accès au niveau du domaine au compte de service, il doit emprunter l'identité d'un utilisateur du domaine. Utilisez ce champ pour entrer l'adresse e-mail de l'utilisateur dont l'identité est utilisée.

Runtime

• Ressources de connexion du runtime ( Runtime connection assets ) : recherchez pour sélectionner une ressource. Ce champ vous permet de sélectionner une ressource différente pour l'exécution. Utilisez le bouton Plus pour sélectionner Chemin relatif ( Relative path ) et entrez le chemin d'accès complet de la ressource Orchestrator contenant les détails de connexion.

Méthode de connexion du panneau Propriétés

• Connexions ( Connections) - Sélectionnez un compte dans la liste. Vous pouvez ajouter, supprimer et choisir les connexions à utiliser.
• Étendues d'authentification ( Authentication Scopes ) : consultez la section de l' assistant Utilisation des étendues d'authentification (Using the Authentication Scopes ) ci-dessous.

Utilisation de l'assistant Étendues d'authentification (Authentication Scopes)

L'activité Étendue (Scope) intègre un sélecteur universel d'autorisations, offrant une image claire de toutes les étendues d'authentification utilisées, dont les activités ont besoin pour fonctionner correctement.

Toutes les activités enfants incluses dans l'activité Google Workspace Application Scope sont automatiquement détectées en tant que portées requises.

Si aucune étendue n'est sélectionnée manuellement dans l'assistant Étendues, la fonction de détection automatique sera appliquée par défaut au moment de l'exécution et il ne sera pas nécessaire de configurer l'assistant. Toutes les étendues minimales requises seront sélectionnées lors de l'exécution.

Vous pouvez également ajouter une étendue manuellement après avoir ajouté une activité enfant à Google Workspace Application Scope.

Remarque : Pour plus de détails sur les étendues et les autorisations des API, consultez Cartes Microsoft 365 et Google Workspace - Autorisations et étendues des API (Microsoft 365 and Google Workspace Cards - API permissions and scopes).

Authentification

• Type d'authentification : une liste déroulante qui indique le type d'authentification que vous souhaitez utiliser pour accéder aux services Google Workspace. Les valeurs de propriété disponibles sont : ApiKey, OAuthClientID et ServiceAccountKey. En fonction du type d'authentification sélectionné, des champs de propriété supplémentaires peuvent être requis.

ID de client OAuth

Remarque : il s'agit de la même méthode d'authentification prise en charge dans Integration Service, soit via l'application UiPath publique, soit via une application personnalisée privée (méthode Fournissez votre propre application).

Les champs de propriété ci-dessous sont requis uniquement si la valeur de Type d'authentification (Authentication Type) est définie sur OAuthClientID.

• IDClient : l'ID d'identification pour le compte d'utilisateur. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
• CléSecrèteClient : le secret d'identification pour le compte d'utilisateur. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
• Client OAuth - indique l'application (client) à utiliser. Si UiPath est sélectionné, aucun ID de client ni clé secrète de client ne doit être fourni. La valeur par défaut est UiPath.
• CléSecrèteClientSécurisée  la clé secrète client du compte utilisateur, sous la forme d’une chaîne sécurisée. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
  Remarque :

  Lorsque vous utilisez des applications UiPath, vous autorisez les robots UiPath à accéder aux données de votre compte de messagerie Google. Par conséquent, vous autorisez UiPath Robots à manipuler les données uniquement en respectant vos instructions. UiPath n'accédera jamais, de quelque manière que ce soit, aux données que vous manipulez en utilisant des Robots UiPath, ne les stockera pas, ne les traitera pas, et n'autorisera pas une utilisation des Robots non conforme aux instructions de l'utilisateur. UiPath utilisera les informations reçues à partir des API Google dans le respect de la Politique relative aux données utilisateur pour les services API Google, y compris les exigences de restrictions d'utilisation.

  Vous pouvez consulter la version intégrale de la Politique de confidentialité UiPath pour plus d'informations.

• Emplacement du magasin de données de connexion - Une liste déroulante qui spécifie où la TokenResponse sera stockée. Les valeurs de propriété disponibles sont Disque local, Orchestrator ou Ne jamais stocker. Cette propriété s'applique uniquement si le type d'authentification sélectionné est OAuthClientID.

• Chemin du dossier Orchestrator de connexion ( Connection Orchestrator Folder Path ) : le dossier Orchestrator dans lequel les opérations sont effectuées. Laissez ce champ vide si les dossiers modernes ne sont pas activés. Pour plus d'informations, consultez À propos des dossiers dans le guide Orchestrator.

• Utilisateur : l'identifiant attribué à un utilisateur autorisé. Un jeton de réponse unique est généré pour chaque identifiant, lequel peut être stocké pour une utilisation future. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne. Cette propriété s'applique uniquement si le type d'authentification sélectionné est OAuthClientID.

Service Account Key

Les champs de propriété ci-dessous sont requis uniquement si la valeur de Type d'authentification (Authentication Type) est définie sur Clé de compte de service (Service Account Key).

• Type de clé : une liste déroulante qui spécifie le type de compte de service, en fonction du fichier de la clé. Les valeurs de propriété disponibles sont JSON ou P12. Pour un compte de service de type P12, les propriétés Mot de passe ( Password ) et E- mail du compte de service (Service Account Email ) sont obligatoires.
• E- mail du compte de service - L'adresse e-mail générée automatiquement pour ce compte de service. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne ; elle est requise uniquement si la valeur de votre Type de clé est P12.
• E- mail de l'utilisateur : si l'option « Contient un accès au niveau du domaine » est sélectionnée, le compte de service empruntera l'identité d'un utilisateur du domaine ; utiliser ce champ pour saisir l'adresse e-mail de l'utilisateur dont l'identité est utilisée.
• A un accès au niveau du domaine : si cette option est sélectionnée, l'activité accorde au compte de service pour l'ensemble du domaine. Valeur booléenne.
• CheminClé : le chemin d'accès au fichier de la clé du compte de service. Cette propriété prend en charge les variables String et les valeurs au format chaîne. La création d'un compte de service sur Google Cloud Platform génère un fichier de clé téléchargeable.
• Mot de passe : le mot de passe du compte de service. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne ; elle est requise uniquement si la valeur de votre Type de clé est P12.
• Compartiment de stockage Orchestrator de clé (Key Orchestrator Storage Bucket) : le compartiment de stockage utilisé pour récupérer les informations d’identification spécifiées par le chemin d’accès à la clé. Si un compartiment de stockage est sélectionné, le champ Chemin d’accès à la clé (Key Path) doit spécifier le chemin d’accès au fichier dans le compartiment de stockage sélectionné. Si aucun compartiment de stockage n’est défini, le chemin d’accès à la clé utilise un stockage local. Si vous sélectionnez le mode d’entrée Chemin complet (Full Path), vous pouvez saisir le chemin du compartiment de stockage sous forme de chaîne ou utiliser une variable.
  Remarque : Avec cette option, vous pouvez utiliser l'authentification par Service Account Key en mode Unattended beaucoup plus facilement. Vous n'avez plus besoin d'ajouter le fichier P12 ou JSON dans le dossier du projet.

Clé API

Le champ de propriété ci-dessous est requis uniquement si la valeur de Type d'authentification (Authentication Type) est définie sur CléAPI.

• Clé API : la clé API du compte. Vous pouvez uniquement utiliser la clé API avec les activités Google Sheets. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne. Si vous souhaitez utiliser les activités Google Mail, Google Calendar et/ou Google Drive, vous devez sélectionner une valeur Type d'authentification (Authentication Type) différente.

Commun

• ContinuerSurErreur (ContinueOnError) : si cette option est définie, les activités restantes sont exécutées si l'activité en cours échoue.
• DélaiAttenteMillisecondes : si cette option est définie, l’activité expirera avec une exception après le nombre défini de millisecondes.

L'utilisation de logiciels développés et fournis par UiPath, conjointement avec des logiciels Google, est soumise au contrat de licence des activités de la plate-forme ouverte d'UiPath. Les logiciels et services Google utilisés conjointement avec les logiciels UiPath sont accessibles et peuvent être utilisés conformément aux conditions de Google et aux autres contrats, politiques ou directives en vigueur fournis par Google.