Como usar as atividades do Google Workspace sem o Integration Service

Sobre

You can now use the newer Google Workspace activities even if you don't have Integration Service, through GSuite Application Scope.

The Google Workspace activities designed specifically for Integration Service feature a Connection field, which enables you to choose a connection created through an Integration Service connector. When used inside GSuite Application Scope, the activities simply inherit the connection information from the Scope.

Matriz de tipos de projetos e autenticação

Google Workspace
	Cloud		No local
	GSuite Application Scope	Integration Service	GSuite Application Scope	Integration Service
Multiplataforma
Chave de API
OAuth — BYOA
OAuth — aplicativo UiPath
Conta de Serviço
Windows
Chave de API
OAuth — BYOA
OAuth — aplicativo UiPath
Conta de Serviço

Métodos de conexão

There are two ways to set up a connection in the GSuite Application Scope activity.

Método de conexão		Description	Benefícios	Desvantagens
Ativo Observação: Recomendado.		Usa um Ativo do Orchestrator para armazenar a conexão com a configuração do Escopo. O ativo está no formato JSON. Sempre que é usada, a atividade recupera a configuração do ativo. Com base na configuração do ativo, o Scope se comporta de maneira diferente; ele identifica o tipo de autenticação e oculta campos desnecessários. Se o JSON do ativo não estiver definido corretamente, ele receberá um erro de validação.	As atividades se beneficiam das pesquisas de tempo de design e podem descobrir arquivos, pastas, listas, intervalos, entre outros. A conexão é facilmente transferível, pois as credenciais não são passadas de um usuário para outro em texto simples. Pode ser configurado por um Admin. É mais seguro, porque as credenciais não chegam no fluxo de trabalho do Studio.	Requer um usuário avançado para configurar o Ativo. Não é fácil configurá-lo para um Desenvolvedor Não Técnico.
Painel de Propriedades		Use o painel de propriedades existente para configurar as credenciais da conexão. A configuração pode ser adicionada em texto simples ou por meio de variáveis.	Mais fácil de usar. Mantém a compatibilidade com versões anteriores.
	Configuração por meio de texto simples Observação: Não é recomendado.	Configure o painel Propriedades com valores de texto simples.	As atividades se beneficiam das pesquisas de tempo de design e podem descobrir arquivos, pastas, listas, intervalos, entre outros.	Menos seguro, porque as credenciais precisam ser passadas entre usuários em texto simples.
	Configuração por meio de variáveis	Configure o painel de propriedades com variáveis.	Mais seguro, porque as credenciais não chegam ao fluxo de trabalho do Studio.	As atividades não podem descobrir quaisquer recursos no momento do design.

Formato de ativo do escopo do aplicativo GSuite

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

Limitações

The following features are not available when using activities inside GSuite Application Scope: triggers, bindings, and override experience.

Atualização do token

Não há nenhum serviço disponível para atualizar seus tokens de conexão, como o que está disponível no Integration Service.

Se o token de autorização não for atualizado por um certo número de dias, ele expirará, e você deve autenticar novamente. Para evitar a expiração de tokens de autorização, execute um UiPath Robot com essa conexão específica. A execução de uma automação com a atividade Scope atualiza o token de autorização.

Recursos adicionais do OAuth 2.0:

• Usar o OAuth 2.0 para acessar as APIs do Google | Autorização | Google para Desenvolvedores