Como usar as atividades do Google Workspace sem o Integration Service

Sobre

Agora você pode usar as atividades mais recentes do Google Workspace mesmo se não tiver o Integration Service, por meio do GSuite Application Scope.

As atividades do Google Workspace projetadas especificamente para o Integration Service apresentam um campo Conexão, que permite escolher uma conexão criada por meio de um conector do Integration Service. Quando usadas dentro do GSuite Application Scope, as atividades simplesmente herdam as informações de conexão do 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

Há duas maneiras de configurar uma conexão na atividade GSuite Application Scope .

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"
}{
    "ApiKey": "",
    "OAuth2ConnectionData": {
        "OAuth2AppData": {
            "ClientId": "",
            "ClientSecret": ""
        }
    },
    "SacConnectionData": {
        "EmailAddress": "",
        "KeyPath": "",
        "ServiceAccountEmail": "",
        "Password": "notasecret",
        "BucketId": "",
        "HasDomainWideAccess": true | false
    },
   "AuthenticationMethod": "oauth2" | "sac" | "apikey"
}

Limitações

Os seguintes recursos não estão disponíveis ao usar atividades dentro do escopo do aplicativo GSuite: gatilhos, associações e experiência de substituição.

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.