GSuite Application Scope

UiPath.GSuite.Activities.GSuiteApplicationScope

Description

Lida com o cliente de conexão e a autenticação das atividades Google Workspace. As atividades Google Workspace funcionam com a conta especificada no escopo do aplicativo.Há vários tipos de autenticação disponíveis.

A partir da versão 2.5.5, você pode usar as atividades mais recentes do Google Workspace dentro da atividade Scope. Para saber como usar as atividades do Integration Service com o Google Workspace Application Scope, consulte Como usar atividades do Google Workspace sem o Integration Service.

Problema conhecido

Importante:

O tipo de autenticação OAuthClientID usando o UiPath OAuth Client (o aplicativo público da UiPath) no Google Workspace Scope está indisponível no momento. As automações usando o aplicativo público da UiPath para autenticar podem parar de funcionar e gerar a seguinte mensagem de erro: "Esse aplicativo está bloqueado". Estamos trabalhando para corrigir o problema e restaurar o aplicativo.

Até que restaure o aplicativo público, você pode usar a autenticação do OAuthClientID com um aplicativo personalizado do Google criado por sua organização. Para alternar do aplicativo público do Google da UiPath para um aplicativo personalizado do Google, siga as seguintes etapas:

1. Crie seu próprio aplicativo do Google Cloud, atribua os escopos necessários e crie as credenciais de ID do cliente do OAuth, conforme explicado em Configurar aplicativos no Google Cloud.
   • O aplicativo público da UiPath usa os seguintes escopos: 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. Você pode usar os mesmos escopos ou atribuir escopos personalizados, dependendo de suas necessidades.
2. Se você selecionar o tipo de autenticação ID do Cliente OAuth, defina o campo Cliente do OAuth como Personalizado. Nos campos ID do Cliente e Segredo do Cliente, adicione as credenciais do seu aplicativo personalizado.
   
   

   

   
   
3. Teste sua automação, republique o projeto e execute-o.

Compatibilidade do projeto

Windows - Legado | Windows

Configuração

• Método de conexão — selecione o método de conexão que você deseja usar. As opções disponíveis no menu suspenso são:
  • Painel de propriedades - Configure os detalhes da conexão no painel de propriedades.
  • Ativo - Use ativos de credenciais do Orchestrator. Recomendamos que você use esta opção.

Método de conexão do ativo

Quando você seleciona essa opção, os campos de autenticação exibidos no Painel de propriedades ficam ocultos, porque todas as informações de autenticação estão armazenadas dentro do ativo.

O método do ativo é compatível com os mesmos tipos de autenticação que o método do painel de propriedades: ID do cliente OAuth, chave de API ou chave de conta de serviço.

• Ativos de conexão - Navegue pelas pastas do Orchestrator para selecionar um ativo. Este campo aceita variáveis IResource . Selecione o botão Gerenciar ativos para abrir o Orchestrator. A lista de ativos disponíveis depende do Orchestrator ao qual seu Studio e o Robô estão conectados.
  • Use o menu do botão Mais para selecionar Recarregar ativos se você tiver atualizado seus ativos no Orchestrator. Observe que se você adicionar um novo ativo no Orchestrator enquanto estiver usando o Studio Desktop, ele não ficará disponível imediatamente na atividade Scope.

Comum

• TimeoutMS - Se definido, a atividade expira com uma exceção após o número definido de milissegundos.

Opções

• Local do repositório de dados de conexão — uma lista suspensa que especifica onde a resposta do token é armazenada. Os valores de propriedades disponíveis são Disco local, Orchestrator ou Nunca armazenar.

  • Disco local – Os tokens de conexão são armazenados em uma pasta local na máquina. A mesma conexão pode ser usada em vários processos na mesma máquina.
  • Orchestrator - Os tokens de conexão são armazenados no Orchestrator como ativos em uma pasta especificada. A mesma conexão pode ser usada em vários processos em várias máquinas, desde que tenha acesso à pasta especificada do Orchestrator.
  • Nunca armazenar - Os tokens de conexão nunca são armazenados.
• Caminho da pasta do Orchestrator de conexão - A pasta do Orchestrator na qual as operações ocorrem. Deixe vazia se pastas Modernas não estiver habilitado. Para obter mais informações, consulte Sobre pastas no Guia do Orchestrator.

Chave da Conta de Serviço

• E- mail do usuário - Se você concedeu Acesso Amplo de Domínio à conta de serviço, ele deve representar um usuário do domínio. Use este campo para inserir o endereço de e-mail do usuário representado.

Runtime

• Ativos de conexão do runtime — Navegue para selecionar um ativo. Esse campo permite que você selecione um ativo diferente para o tempo de execução. Use o menu do botão Mais para selecionar Caminho relativo e insira o caminho completo do ativo do Orchestrator contendo detalhes da conexão.

Método de conexão do Painel de propriedades

• Conexões - Selecione uma conta da lista. Você pode adicionar, excluir e escolher quais conexões usar.
• Escopos de autenticação - Consulte a seção do assistente Usando os escopos de autenticação abaixo.

Usando o assistente de Escopos de autenticação

A atividade Scope incorpora um seletor de permissões universais, oferecendo uma imagem clara de todos os escopos de autenticação usados, dos quais as atividades precisam para funcionar corretamente.

Todas as atividades filho incluídas na atividade Google Workspace Application Scope são detectadas automaticamente como escopos exigidos.

Se nenhum escopo for selecionado manualmente no assistente de Escopos, a função Detecção automática é aplicada por padrão no runtime, e a necessidade de configurar o assistente é eliminada. Todos os escopos mínimos exigidos são selecionados no runtime.

Você também pode adicionar um escopo manualmente após adicionar uma atividade filha ao Google Workspace Application Scope.

Observação: para obter detalhes sobre escopos e permissões de APIs, consulte Microsoft 365 e Google Workspace Cards - Permissões e escopos de APIs.

Autenticação

• Tipo de Autenticação - Uma lista suspensa que especifica o tipo de autenticação que você deseja usar para acessar os serviços do Google Workspace. Os valores de propriedades disponíveis são: ChaveDaApi, IDDeClienteOAuth e ChaveDaContaDeServiço. Dependendo da seleção do tipo de autenticação, podem ser exigidos campos de propriedades adicionais.

ID do Cliente OAuth

Observação: esse é o mesmo método de autenticação suportado no Integration Service, seja por meio do aplicativo UiPath público ou de um aplicativo personalizado privado (método Traga seu próprio aplicativo).

Os campos de propriedades abaixo são exigidos apenas se o valor de seu Tipo de autenticação for IDDeClienteOAuth.

• ID do cliente — o ID da credencial da conta do usuário. Essa propriedade é compatível com variáveis String e valores formatados de string.
• Segredo do cliente - O segredo da credencial da conta do usuário. Essa propriedade é compatível com variáveis String e valores formatados de string.
• Cliente OAuth — indica o aplicativo (cliente) a ser usado. Se UiPath for selecionado, não será necessário fornecer ID do cliente e Segredo do cliente . O valor padrão é UiPath.
• Segredo do cliente seguro - O segredo do cliente para a conta do usuário, como uma string segura. Essa propriedade é compatível com variáveis String e valores formatados de string.
  Observação:

  Quando usar os aplicativos UiPath, você permitirá que os UiPath Robots acessem os dados dentro de sua conta de email do Google. Posteriormente, você permitirá que os UiPath Robots manipulem os dados apenas de acordo com suas instruções. O UiPath nunca acessará, armazenará ou processará de nenhuma maneira os dados que você manipula com o uso dos UiPath Robots e não permitirá que os Robots sejam usados fora das instruções do usuário. O uso pela UiPath das informações recebidas dos APIs do Google cumprirá a Política de Dados do Usuário de Serviços de API do Google, incluindo os requisitos de uso limitado.

  Você pode ver consultar a Política de Privacidade da UiPath na íntegra para obter mais informações.

• Local do armazenamento de dados de conexão — uma lista suspensa que especifica onde a RespostaDoToken é armazenada. Os valores de propriedades disponíveis são Disco local, Orchestrator ou Nunca armazenar. Essa propriedade é aplicável apenas se o Tipo de autenticação selecionado for OAuthClientID.

• Caminho da pasta do Orchestrator de conexão - A pasta do Orchestrator na qual as operações ocorrem. Deixe vazia se pastas Modernas não estiver habilitado. Para obter mais informações, consulte Sobre pastas no Guia do Orchestrator.

• Usuário - O identificador atribuído a um usuário autorizado. Um token de resposta único é gerado para cada identificador que pode ser armazenado para uso futuro. Essa propriedade é compatível com variáveis String e valores formatados de string. Essa propriedade é aplicável apenas se o Tipo de autenticação selecionado for OAuthClientID.

Chave da Conta de Serviço

Os campos de propriedades abaixo são exigidos apenas se o valor de seu Tipo de autenticação for Chave de conta de serviço.

• Tipo de Chave - Uma lista suspensa que especifica o tipo de conta de serviço, de acordo com o arquivo de chave. Os valores de propriedades disponíveis são JSON ou P12. Para um tipo de conta de serviço P12, as propriedades Senha e E- mail da conta de serviço são exigidas.
• Email da conta de serviço - O endereço de email gerado automaticamente para a conta de serviço. Essa propriedade é compatível com String variáveis e valores formatados de string e é exigida apenas se o valor de seu Tipo de chave for P12.
• E- mail do usuário - Se Tem acesso amplo de domínio estiver selecionado, a conta de serviço representa um usuário do domínio; use este campo para inserir o endereço de e-mail do usuário representado.
• Tem acesso a todo o domínio - Se estiver selecionado, a atividade concede acesso a todo o domínio à conta de serviço. Valor booleano.
• Caminho da Chave - O caminho para o arquivo de chave da conta de serviço. Essa propriedade é compatível com variáveis String e valores formatados de string. A criação de uma conta de serviço na Plataforma Google Cloud gera um arquivo de chave para download.
• Senha - A senha para a conta de serviço. Essa propriedade é compatível com String variáveis e valores formatados de string e é exigida apenas se o valor de seu Tipo de chave for P12.
• Bucket de armazenamento do Orchestrator Principal - O bucket de armazenamento usado para recuperar as credenciais especificadas por Caminho da chave.Se um Bucket de armazenamento for selecionado, o campo Caminho da chave deve especificar o caminho do arquivo no Bucket de armazenamento selecionado.Se um Bucket de armazenamento não for definido, o Caminho da chave usará um armazenamento local. Se você selecionar o modo de entrada Caminho completo, você pode inserir o caminho do bucket de armazenamento como uma string ou usar uma variável.
  Observação: com essa opção, você pode usar a autenticação Chave de conta de serviço no modo não assistido com muito mais facilidade. Não é mais necessário adicionar o arquivo P12 ou JSON na pasta do projeto.

Chave de API

O campo de propriedade abaixo é exigido apenas se o valor de Tipo de autenticação for ChaveDaApi.

• Chave de API - A chave de API da conta. Você só pode usar a chave de API com as atividades do Google Sheets. Essa propriedade é compatível com variáveis String e valores formatados de string. Se você desejar usar as atividades do Google Mail, Google Calendar e/ou Google Drive, você deve selecionar um valor de Tipo de Autenticação diferente.

Comum

• ContinueOnError - Se definido, as atividades restantes serão executadas se a atividade atual falhar.
• TimeoutMS - Se definido, a atividade expira com uma exceção após o número definido de milissegundos.

O uso do software desenvolvido e fornecido pela UiPath em conexão com qualquer software do Google está sujeito ao Contrato de Licença de Atividades da Plataforma Aberta UiPath. O software e os serviços do Google usados em conjunto com o software da UiPath podem ser acessados e usados de acordo com os Termos do Google e quaisquer outros acordos, políticas ou diretrizes aplicáveis, conforme disponibilizado pelo Google.