Comment utiliser les activités Google Workspace sans Integration Service

À propos

Vous pouvez désormais utiliser les nouvelles activités de Google Workspace même si vous n'avez pas Integration Service, via GSuite Application Scope.

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

Matrice des types d'authentification et 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 manières 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.

Étendue d'application GSuite (GSuite Application Scope) - Format de ressource

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

Limitations

Les fonctionnalités suivantes ne sont pas disponibles lors de l'utilisation d'activités à l'intérieur de 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 expirera et vous devrez 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.