Autenticação do Gmail

Pré-requisitos

Dependendo do tipo de autenticação selecionado, você precisará de uma das seguintes credenciais:

• Código de autorização do OAuth 2.0: seu endereço de e-mail do Google e a senha associada a sua conta do Google.
• Traga seu próprio aplicativo OAuth 2.0: o ID do cliente, o segredo do cliente e os escopos do seu aplicativo.
• Conta de serviço: Chave da conta de serviço, Email da conta.

Se sua conta não for habilitada pelo Google:

• Entre em contato com o administrador para obter aprovações sobre a criação de conexões.
• Habilite a permissão marcando as opções disponíveis para permitir a criação de uma conexão.

Note: For more details regarding the different authentication types, see the How to connect to Google Workspace 365 activities guide.

Para obter mais informações sobre o Gmail, visite o site da documentação do Gmail .

Escopos

O conector solicita as seguintes permissões/escopos:

• Escopos padrão de aplicativos públicos do UiPath: openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, https://mail.google.com/, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/gmail.settings.basic.
• Escopos padrão de conta de serviço: openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, https://mail.google.com/, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/gmail.settings.basic.
• Traga seu próprio aplicativo OAuth 2.0:
  • Escopos mínimos para criar uma conexão: openid, https://www.googleapis.com/auth/gmail.readonly.
  • Lista mínima de escopos necessários para gatilhos do Gmail:
    • openid, https://www.googleapis.com/auth/gmail.readonly – para evento em caixas de correio.
    • openid, https://www.googleapis.com/auth/calendar.readonly – para eventos em calendários.

Observação: se você se autenticar usando o aplicativo Traga seu próprio OAuth 2.0, por padrão, você se beneficia dos escopos configurados na criação do aplicativo. Se você quiser usar as permissões padrão do aplicativo, você pode declarar um escopo common . Isso significa que você usa apenas as permissões configuradas para esse aplicativo. Você também pode declarar escopos adicionais na criação da conexão, usando o campo Escopos . Em seguida, você será solicitado a conceder o consentimento adicional durante o login.

A conexão permite que os produtos da UiPath interajam com dados do Gmail em seu nome. Isso pode incluir dados de leitura, gravação, modificação e exclusão, dependendo das permissões do seu Gmail. Você pode remover qualquer acesso em sua Conta do Google.

Adicionar a conexão do Gmail

1. Selecione o Integration Service do Automation Cloud^TM.

2. Na lista Conectores , selecione Gmail. Você também pode usar a barra de pesquisa para encontrar o conector.
3. Selecione o botão Adicionar conexão .

4. Agora você será redirecionado para a página de conexão. Selecione seu tipo de autenticação preferido.

   Se você selecionar Trazer seu próprio aplicativo OAuth 2.0, você deve fornecer um ID do Cliente e Segredo do Cliente, e os Escopos que você pode precisar para interagir com diferentes atividades. Verifique a documentação das atividades para ver quais escopos elas exigem.

5. Sua conexão foi adicionada.

Traga seu próprio aplicativo OAuth 2.0

No Integration Service, ao criar uma conexão com um de nossos conectores baseados na API do Google, você pode escolher entre duas opções de autenticação:

• Código de autorização do OAuth 2.0 — que se conecta ao aplicativo público do UiPath.

• Traga seu próprio aplicativo OAuth 2.0 – que se conecta a um aplicativo privado que você cria.

Para saber como criar um aplicativo, acesse a documentação oficial do Google e siga as etapas descritas: Autenticação — entre com o Google for Web.

• Ao configurar seu aplicativo, defina o campo URIs de redirecionamento autorizados como: https://cloud.uipath.com/provisioning_/callback

Configuração de escopos

Ao criar uma conexão usando o aplicativo Traga seu próprio OAuth 2.0, você tem a opção de personalizar os escopos do aplicativo.

Tokens de atualização para aplicativos OAuth

O Google tem limitações de token de atualização para IDs de clientes individuais do OAuth 2.0. Se o limite for atingido, a criação de um novo token de atualização invalida automaticamente o token de atualização mais antigo sem aviso. Esse limite não se aplica a contas de serviço (consulte Uso do OAuth 2.0 para aplicativos servidor a servidor). Para obter mais informações, consulte a documentação oficial do Google.

Uma lista de motivos que podem causar a expiração do token:

• Você revogou o acesso do aplicativo.
• O token de atualização não é usado há seis meses.
• Você precisa alterar senhas e o token de atualização contém escopos do Gmail.
• Sua conta excedeu o número máximo de tokens de atualização (ativos) concedidos.
  • Se você solicitar um novo token após o limite ter sido excedido, sua conexão antiga, com base em um token concedido anteriormente, expirará. Apenas a nova conexão ou a última conexão editada/reautenticada (com o token mais recente) funcionará.
• Um administrador definiu qualquer um dos serviços solicitados nos escopos do seu aplicativo como Restrito (o erro é admin_policy_enforced).
• Para APIs do Google Cloud Platform: a duração da sessão definida pelo administrador pode ter sido excedida.

Observação: o limite está definido atualmente em 100 tokens de atualização por conta do Google por ID do cliente OAuth 2.0. Esse número pode estar sujeito a alterações. Para obter as informações mais recentes, consulte sempre a Documentação do Google.

Há um limite maior para o número total de tokens de atualização que uma conta de usuário ou conta de serviço pode ter em todos os clientes. Usuários regulares não excederão esse limite, mas uma conta de desenvolvedor usada para testar uma implementação pode.

Para garantir que esse limite não seja excedido, a UiPath oferece aos usuários a capacidade de criar seus próprios aplicativos OAuth e se conectar usando o tipo de autenticação Traga seu próprio aplicativo. Certifique-se de seguir as práticas recomendadas do Google ao criar seu aplicativo OAuth. Para obter detalhes sobre como criar um aplicativo OAuth, consulte a documentação oficial do Google.

Aviso: a invalidação do token resulta em conexões com falha e as automações não podem ser executadas sem corrigir as conexões.