Ação Conectar para pacotes do Google

Use a ação Conectar para estabelecer uma conexão com o servidor Google, a fim de utilizar outras ações a partir desse mesmo pacote para automatizar tarefas. Todos os campos desta ação aceitam uma credencial do Cofre de credenciais ou um valor de entrada de usuário.

Pré-requisitos

Configure as configurações do OAuth no Google Cloud Platform e recuperar as credenciais necessárias para conectar Automation Anywhere com suas aplicações Google G Suite.
  1. Se você ainda não o fez, crie um projeto.
  2. Habilitar as APIs para as aplicações Google G Suite que você deseja automatizar, tais como a API Google Drive, a API Google Calendar e a API Google Sheets.
  3. Siga as etapas em Configurar OAuth 2.0 para gerar a ID e o Segredo do Cliente.
    Nota:
    • Selecione a opção Aplicativo da Web e insira um nome.
    • Com base no modo de autenticação, insira o URI de redirecionamento relevante conforme indicado abaixo:
      • Código de autorização (modo de autenticação padrão): Adicione este URI de redirecionamento autorizado: http://localhost:8888/Callback
      • Control Room gerenciada: Adicione o URL de retorno de chamada da página Control Room > Gerenciar > Conexões OAuth > Configurações de conexão. Consulte Criar a conexão de OAuth.

Procedimento

  1. Na paleta Ações, clique duas vezes ou arraste a ação Conectar do pacote que deseja usar.
  2. No campo Nome de usuário, você pode fornecer um nome de usuário válido ou selecionar a credencial ou a variável de credencial que contém seu nome de usuário do Google. Para inserir um valor, clique em String insegura.
  3. Se você estiver configurando a ação Conectar para o pacote Google Calendar ou Google Sheets, insira o nome de uma sessão.
  4. Clique no menu suspenso Modo de autenticação de OAuth2 e selecione um dos seguintes modos de autenticação:

    Para um modo de autenticação assistida, selecione Código de autorização, o qual é um fluxo legado e não seguro. Para o modo de autenticação não assistido, selecione a autenticação OAuth2 Gerenciada pela Control Room, um modelo mais seguro e padronizado para automações.

    • Código de autorização
      • No campo ID do cliente, selecione a credencial ou a variável credencial que contém a ID do cliente. Para inserir um valor, clique em String insegura.
      • No campo URI redirecionado, insira http://localhost:8888/Callback
        Nota: Para o pacote Google Sheets, o URI redirecionado não é compatível. Digite o URL de redirecionamento fixa diretamente em Google Cloud Platform: http://localhost:8888/Callback
      • No campo Segredo do cliente, selecione a credencial ou a variável de credencial que contém o token de acesso. Para inserir um valor, clique em String insegura.
    • Control Room gerenciada:

      Para usar o OAuth2 gerenciado pela Control Room nos pacotes Google, configure a conexão OAuth na Control Room. Consulte Criar a conexão de OAuth.

      Atualize as informações nos seguintes campos:

      • Conexão: Clique no botão Escolher para selecionar um tipo de conexão.
      • Selecione Personalizado no campo Tipo de provedor.

      • Selecione o nome da conexão que configurou na Control Room para aplicativos do Google Workspace.

      • Use o campo Tipo de token para selecionar uma das seguintes opções:

        Para informações sobre os tokens de acesso e atualização do aplicativo Google Workspace, consulte Configurar aplicativos corporativos

        • Compartilhado: Selecione essa opção quando o token de acesso do OAuth2 for compartilhado para todos os usuários que executam a automação. Observe que isso exige que o administrador ou qualquer usuário da Control Room (com as opções Gerenciar conexões e Exibir conexões habilitadas para CONEXÕES OAUTH) configure uma conexão do OAuth na Control Room. Salve as credenciais de login uma vez para gerar um token de acesso compartilhado que possa ser consumido por todos os usuários que executam a automação.
        • Específico do usuário: Selecione esta opção quando o token de acesso do OAuth2 for específico para cada usuário que executa a automação. Observe que isso exige que o administrador ou qualquer usuário da Control Room (com as opções Gerenciar conexões e Exibir conexões habilitadas para CONEXÕES OAUTH) configure uma conexão do OAuth na Control Room. Certifique-se de não salvar as credenciais de login para que cada usuário que executa a automação possa fornecer as próprias credenciais de login e gerar um token de acesso que só possa ser consumido por esse usuário específico.
        • Clique em Confirmar.

          Uso da opção do OAuth2 gerenciado pela Control Room

      Nota: Ao usar a opção Específico do usuário, faça login em sua conta do Google para autenticar e gerar um token específico do usuário. Execute as seguintes etapas para usar esta opção:
      1. Na Control Room, navegue até seu perfil Minhas configurações > Conexões OAuth.
      2. Clique em Login para autenticar.
      3. Faça login em sua conta do Google e selecione Continuar.
      4. Verifique os serviços aos quais você tem acesso e clique em Continuar.

        Se a conexão for bem-sucedida, o status será exibido como Ativo.

        Status de êxito da autenticação do OAuth

  5. Para Google Sheets, você pode especificar o tempo de espera (em minutos) no campo Esperar a ação para concluir (em minutos) ao executar ações tais como Obter, Definir ou Excluir. Por padrão, o tempo de espera é de 10 minutos.
    Se a planilha do Google não abrir dentro do tempo especificado, a tarefa prossegue para executar o próximo conjunto de ações.
    Nota: Quando você usa a ação Conectar para se conectar ao servidor Google, a opção Esperar a ação para concluir (em minutos) só é compatível com o pacote Google Sheets.
  6. Clique em Salvar.
  7. Depois de adicionar ações de um pacote Google específico, utilize a ação Desconectar desse mesmo pacote Google para encerrar a conexão.

Próximas etapas

A primeira vez que o bot for executado, a janela de login do Google aparecerá. Você deve selecionar a conta Google e aprovar as permissões de acesso solicitadas.

Este arquivo de token é gerado pela primeira vez após você fornecer as permissões de acesso, quando o bot é implantado. Ele é criado com base nos valores que você fornece no Nome de usuário, ID do cliente e Segredo do cliente e pede credenciais apenas pela primeira vez para fornecer a permissão de acesso. Da próxima vez, ele usa o mesmo arquivo de token para se conectar ao Google Sheets.

O arquivo de token está localizado em C:\Users\<username>\AppData\Local\AutomationAnywhere\G-SuitAuth, onde C:\Users\<username> é o diretório da página inicial do usuário do respectivo sistema.

Se você digitar as credenciais corretas ao fornecer permissões de acesso pela primeira vez e puder se conectar com o Google Sheets com sucesso, da próxima vez que houver uma mudança apenas na senha, você não precisará apagar o arquivo de token, pois ele funcionará como esperado.

Use outras as ações do mesmo pacote Google para automatizar tarefas. Para usar as ações de outros pacotes do Google, estabeleça uma conexão usando a ação Conectar desse pacote.