Comment utiliser les activités Google Workspace sans Integration Service

À propos

Vous pouvez désormais utiliser les nouvelles activités Google Workspace même si vous n’avez pas Integration Service, via Étendue d’application GSuite.

Les activités Google Workspace conçues spécifiquement pour Integration Service disposent d’un champ Connexion, qui permet de choisir une connexion créée via un connecteur Integration Service. Lorsqu'elles sont utilisées dans l' activité GSuite Application Scope, les activités héritent simplement des informations de connexion de l'étendue.

Authentification et matrice des types de projets

Google Workspace
	Cloud		Version locale
	GSuite Application Scope	Integration Service	GSuite Application Scope	Integration Service
Multiplateforme
Clé API	❌	❌	❌	❌
OAuth – BYOA	❌	✅	❌	❌
OAuth – application UiPath	❌	✅	❌	❌
Compte de service	❌	❌	❌	❌
Windows
Clé API	✅	❌	✅	❌
OAuth – BYOA	✅	✅	✅	❌
OAuth – application UiPath	✅	✅	✅	❌
Compte de service	✅	❌	✅	❌

Méthodes de connexion

Il existe deux façons de configurer une connexion dans l'activité GSuite Application Scope .

Méthode de connexion		Description	Bénéfices	Inconvénients
Ressource Remarque : Recommandé.		Utilise une ressource Orchestrator pour stocker la connexion avec la configuration de l'étendue. La ressource est au format JSON. Chaque fois qu'elle est utilisée, l'activité récupère la configuration de la ressource. En fonction de la configuration des ressources, l'activité Scope se comporte différemment ; il identifie le type d'authentification et masque les champs inutiles. Si la ressource JSON n’est pas correctement définie, une erreur de validation s’affiche.	Les activités bénéficient des recherches au moment de la conception et peuvent découvrir des fichiers, des dossiers, des listes, des plages et d'autres. La connexion est facilement transférable, car les informations d'identification ne sont pas transmises d'un utilisateur à un autre en texte brut. Peut être configuré par un administrateur. C'est plus sécurisé, car les informations d'identification n'atteignent pas le workflow Studio.	Nécessite qu'un utilisateur avancé configure la ressource. Pas facile à mettre en place par un Citizen Developer.
Panneau propriétés		Utiliser le panneau Propriétés (Properties) existant pour configurer les identifiants de connexion. La configuration peut être ajoutée en texte brut ou via des variables.	Plus facile à utiliser. Assure la rétrocompatibilité.
	Configuration en texte brut Remarque : Non recommandé.	Configurez le panneau Propriétés (Properties) avec des valeurs en texte brut.	Les activités bénéficient des recherches au moment de la conception et peuvent découvrir des fichiers, des dossiers, des listes, des plages et d'autres.	Moins sécurisé, car les informations d'identification doivent être transmises entre les utilisateurs en texte brut.
	Configuration via des variables	Configurez le panneau Propriétés avec des variables.	Plus sécurisé, car les informations d'identification n'atteignent pas le workflow Studio.	Les activités ne peuvent découvrir aucune ressource au moment de la conception.

Format de ressource de l'étendue d'application GSuite

{
    "ApiKey": "",
    "OAuth2ConnectionData": {
        "OAuth2AppData": {
            "ClientId": "",
            "ClientSecret": ""
        }
    },
    "SacConnectionData": {
        "EmailAddress": "",
        "KeyPath": "",
        "ServiceAccountEmail": "",
        "Password": "notasecret",
        "BucketId": "",
        "HasDomainWideAccess": true | false
    },
   "AuthenticationMethod": "oauth2" | "sac" | "apikey"
}

Limitations

Les fonctionnalités suivantes ne sont pas disponibles lors de l'utilisation d'activités dans l'activité GSuite Application Scope: déclencheurs, liaisons et expérience de remplacement.

Actualisation du jeton

Aucun service n'est disponible pour actualiser vos jetons de connexion, comme celui disponible dans Integration Service.

Si le jeton d’autorisation n’est pas actualisé pendant un certain nombre de jours, il expire et vous devez vous authentifier à nouveau. Pour éviter l’expiration des jetons d’autorisation, exécutez un robot avec cette connexion spécifique. L’exécution d’une automatisation avec l’activité Étendue (Scope) actualise le jeton d’autorisation.

Ressources OAuth 2.0 supplémentaires :

• Utiliser OAuth 2.0 pour accéder aux API Google | Autorisation | Google pour les développeurs