Acción de conexión para paquetes de Google

Use la acción Conectar para establecer una conexión con el servidor de Google a fin de utilizar otras acciones de ese mismo paquete para automatizar tareas. Todos los campos de esta acción aceptan una credencial de la Credential Vault, una variable o un valor introducido por el usuario.

Antes de empezar

Configure los ajustes de OAuth en el Plataforma de nube de Google y recupere las credenciales necesarias para conectar Automation Anywhere con sus aplicaciones de Conjunto Google G.
  1. Si aún no lo ha hecho, cree un proyecto.
  2. Habilitar las API para las aplicaciones de Conjunto Google G que desea automatizar, como la API Google Drive, la API Google Calendar y la API Google Sheets.
  3. Realice los pasos en Configuración de OAuth 2.0 para generar el ID y el Secreto de cliente.
    Nota:
    • Seleccione la opción Aplicación web e ingrese un nombre.
    • Según el modo de autenticación, ingrese el URI de redireccionamiento relevante como se indica a continuación:
      • Código de autorización (modo de autenticación predeterminado): Agregue esta URI de redireccionamiento autorizada: http://localhost:8888/Callback
      • Control Room administrada Agregue la URL de devolución de llamada desde la página Control Room > Administrar > Conexiones OAuth > Configuración de conexión. Consulte Crear conexiones ‌OAuth.

Procedimiento

  1. En la paleta de Acciones , haga doble clic en la acción Conectar desde el paquete que desea usar, o arrástrela.
  2. En el campo Nombre de usuario, puede proporcionar un nombre de usuario válido o seleccionar la credencial o la variable de credencial que contiene su nombre de usuario de Google. Para introducir un valor, haga clic en Cadena insegura.
  3. Si está configurando la acción Conectar para el paquete Google Calendar o Google Sheets, introduzca un nombre de sesión.
  4. Haga clic en el menú desplegable Modo de autenticación OAuth2 y seleccione uno de los siguientes modos de autenticación:

    Para un modo de autenticación asistido, seleccione Código de autorización, que es un flujo heredado y no seguro. Para el modo de autenticación no asistida, seleccione la autenticación OAuth2 de Control Room administrada, un modelo más seguro y estándar para automatizaciones.

    • Código de autorización
      • En el campo ID de cliente, seleccione la credencial o la variable de credencial que contiene el ID de cliente. Para introducir un valor, haga clic en Cadena insegura.
      • En el campo URI de redireccionamiento, ingrese http://localhost:8888/Callback.
        Nota: Para el paquete Google Sheets, el atributo URI de redireccionamiento no es compatible. Introduzca la URL de redireccionamiento fija directamente en Plataforma de nube de Google: http://localhost:8888/Callback
      • En el campo Secreto del cliente, seleccione la credencial o la variable de credencial que contiene el token de acceso. Para introducir un valor, haga clic en Cadena insegura.
    • Control Room administrada

      Para usar OAuth2 de Control Room administrada en los paquetes de Google, debe configurar la conexión OAuth en la Control Room. Consulte Crear conexiones ‌OAuth.

      Actualice la información en los siguientes campos:

      • Conexión: Haga clic en el botón Elegir para seleccionar un tipo de conexión.
      • Seleccione Personalizado en el campo Tipo de proveedor.

      • Seleccione el nombre de la conexión que configuró en la Control Room para aplicaciones de Google Workspace.

      • Utilice el campo Tipo de implementación para seleccionar una de las siguientes opciones:

        Para obtener información sobre los tokens de acceso y actualización de la aplicación Google Workspace, consulte Configurar aplicaciones empresariales

        • Compartido: Seleccione esta opción cuando el token de acceso de OAuth2 se comparta para todos los usuarios que ejecutan la automatización. Tenga en cuenta que esto requiere que el administrador de la Control Room o cualquier usuario (con las opciones Administrar conexiones y Ver conexiones habilitadas para CONEXIONES OAUTH) configure una conexión OAuth en la Control Room. Guarde las credenciales de inicio de sesión una vez para generar un token de acceso compartido que puedan usar todos los usuarios que ejecutan la automatización.
        • Específico del usuario: Seleccione esta opción cuando el token de acceso de OAuth2 sea específico para cada usuario que ejecuta la automatización. Tenga en cuenta que esto requiere que el administrador de la Control Room o cualquier usuario (con las opciones Administrar conexiones y Ver conexiones habilitadas para CONEXIONES OAUTH) configure una conexión OAuth en la Control Room. Asegúrese de no guardar las credenciales de inicio de sesión para que cada usuario que ejecute la automatización pueda proporcionar sus credenciales de inicio de sesión y generar un token de acceso que solo pueda ser usado por ese usuario específico.
        • Haga clic en Confirm (Confirmar).

          Uso de la opción OAuth2 de la Control Room administrada

      Nota: Cuando utiliza la opción Específico del usuario, debe iniciar sesión en su cuenta de Google para autenticarse y generar un token específico del usuario. Realice los siguientes pasos para utilizar esta opción:
      1. En la Control Room, navegue hasta su perfil Mi configuración > Conexiones OAuth.
      2. Haga clic en Iniciar sesión para autenticarse.
      3. Inicie sesión en su cuenta de Google y seleccione Continuar.
      4. Verifique los servicios a los que tiene acceso y haga clic en Continuar.

        Si la conexión se realiza de manera correcta, mostrará el estado como Activo.

        Estado exitoso de la autenticación OAuth

  5. Para Google Sheets, puede especificar el tiempo de espera (en minutos) en el campo Esperar a que se complete la acción (en minutos) al realizar acciones como Obtener, Establecer o Eliminar. De manera predeterminada, el tiempo de espera es de 10 minutos.
    Si la hoja de Google no se abre en el tiempo especificado, la tarea continúa con la ejecución del conjunto siguiente de acciones.
    Nota: Cuando se utiliza la acción Conectar para conectarse al servidor de Google, la opción Esperar a que se complete la acción (en minutos) solo es compatible con el paquete Google Sheets.
  6. Haga clic en Guardar.
  7. Después de agregar acciones de un paquete de Google específico, utiliza la acción Desconectar de ese mismo paquete de Google para finalizar la conexión.

Qué hacer a continuación

La primera vez que se ejecuta el bot, se muestra la ventana de inicio de sesión de Google. Debe seleccionar la cuenta de Google y aprobar los permisos de acceso solicitados.

El archivo de token se genera por primera vez después de proporcionar los permisos de acceso cuando se implementa el bot. Se crea en función de los valores que usted proporciona en los campos Nombre de usuario, ID de cliente y Secreto del cliente, y solicita las credenciales solo la primera vez para proporcionar el permiso de acceso. La próxima vez utiliza el mismo archivo de token para conectarse a Google Sheets.

El archivo de token se encuentra en C:\Users<username>\AppData\Local\AutomationAnywhere\G-SuitAuth, donde C:\Users<username> es el directorio de inicio del usuario del sistema correspondiente.

Si introduce las credenciales correctas cuando proporciona los permisos de acceso por primera vez y puede conectarse a Google Sheets con éxito, la próxima vez, si hay un cambio solo en la contraseña, no es necesario eliminar el archivo de token, ya que funcionará según lo esperado.

Use otras acciones del mismo paquete de Google para automatizar tareas. Para utilizar acciones de otros paquetes de Google, establezca una conexión mediante la acción Conectar de ese paquete.