Ámbito de la aplicación GSuite

UiPath.GSuite.Activities.GSuiteApplicationScope

Descripción

Gestiona el cliente de conexión y la autenticación para las actividades de Google Workspace. Las actividades de Google Workspace funcionan con la cuenta especificada en el ámbito de Aplicación. Hay varios tipos de autenticación disponibles.

A partir de la versión 2.5.5, puedes utilizar las actividades de Google Workspace más recientes dentro de la actividad de alcance. Para aprender a utilizar las actividades de Integration Service con el alcance de la aplicación de Google Workspace, consulta Cómo utilizar las actividades de Google Workspace sin Integration Service.

Problema conocido

Importante:

El tipo de autenticación OAuthClientID utilizando el cliente UiPath OAuth (la aplicación pública UiPath) en el ámbito de Google Workspace no está disponible actualmente. Las automatizaciones que utilizan la aplicación pública de UiPath para autenticarse pueden dejar de funcionar y mostrar el siguiente mensaje de error: "Esta aplicación está bloqueada". Trabajamos para solucionar el problema y restaurar la aplicación.

Hasta que restauremos la aplicación pública, puedes utilizar la autenticación OAuthClientID con una aplicación personalizada de Google creada por tu organización. Para cambiar de la aplicación pública de Google UiPath a una aplicación de Google personalizada, sigue los siguientes pasos:

1. Crea tu propia aplicación de Google Cloud, asigna los ámbitos necesarios y crea las credenciales de ID de cliente OAuth, como se explica en Configurar aplicaciones en Google Cloud.
   • La aplicación pública de UiPath utiliza los siguientes ámbitos: 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. Puedes utilizar los mismos ámbitos o asignar unos personalizados, dependiendo de tus necesidades.
2. Si seleccionas el tipo de autenticación OAuthClientID, establece el campo Cliente OAuth en Personalizado. En los campos ID de cliente y Secreto de cliente, añade las credenciales de tu aplicación personalizada.
   
   

   

   
   
3. Prueba tu automatización, vuelve a publicar el proyecto y ejecútalo.

Compatibilidad de proyectos

Windows: heredado | Windows

Configuración

• Método de conexión : selecciona el método de conexión que deseas utilizar. Las opciones disponibles en el menú desplegable son:
  • Panel de propiedades : configura los detalles de la conexión en el panel de propiedades.
  • Activo : utiliza activos de credenciales de Orchestrator. Te recomendamos que utilices esta opción.

Método de conexión de activos

Al seleccionar esta opción, los campos de autenticación que se muestran en la opción Panel de propiedades se ocultan, porque toda la información de autenticación se almacena dentro del activo.

El método Activo admite los mismos tipos de autenticación que el método Panel de propiedades: ID de cliente OAuth, clave API o clave de cuenta de servicio.

• Activos de conexión : explora las carpetas de Orchestrator para seleccionar un activo. Este campo admite variables IResource . Selecciona el botón Administrar activos para abrir Orchestrator. La lista de activos disponibles depende del Orchestrator al que estén conectados Studio y UiPath Robot.
  • Utiliza el menú del botón Más para seleccionar Volver a cargar activos si has actualizado tus activos en Orchestrator. Ten en cuenta que si añades un nuevo activo en Orchestrator mientras utilizas Studio Desktop, no estará disponible de inmediato en la actividad Ámbito.

Común

• TimeoutMS : si se establece, la actividad agota el tiempo de espera con una excepción después del número de milisegundos establecido.

Opciones

• Ubicación del almacén de datos de conexión : una lista desplegable que especifica dónde se almacena la respuesta del token. Los valores de propiedad disponibles son Disco local, Orchestrator o No almacenar nunca.

  • Disco local : los tokens de conexión se almacenan en una carpeta local en la máquina. La misma conexión puede utilizarse en varios procesos en la misma máquina.
  • Orchestrator : los tokens de conexión se almacenan en Orchestrator como activos en una carpeta especificada. La misma conexión puede utilizarse en varios procesos en varias máquinas siempre que tenga acceso a la carpeta de Orchestrator especificada.
  • Nunca almacenar : los tokens de conexión nunca se almacenan.
• Ruta de la carpeta de Orchestrator de conexión : la carpeta de Orchestrator donde se producen las operaciones. Dejar vacío si las carpetas modernas no están habilitadas. Para obtener más información, consulta Acerca de las carpetas en la Guía de Orchestrator.

Clave de cuenta de servicio

• Correo electrónico del usuario : si has concedido acceso a todo el dominio a la cuenta de servicio, esta debe suplantar a un usuario del dominio. Utiliza este campo para introducir la dirección de correo electrónico del usuario suplantado.

Tiempo de ejecución

• Activos de conexión de Runtime : navega para seleccionar un activo. Este campo te permite seleccionar un activo diferente para el tiempo de ejecución. Utiliza el menú del botón Más para seleccionar Ruta relativa e introduce la ruta completa del activo de Orchestrator que contiene los detalles de la conexión.

Método de conexión del panel de propiedades

• Conexiones : selecciona una cuenta de la lista. Puedes añadir, eliminar y elegir qué conexiones usar.
• Ámbitos de autenticación : consulta la sección Uso del asistente de Ámbitos de autenticación a continuación.

Uso del asistente de Ámbitos de autenticación

La actividad Ámbito incorpora un selector de permisos universal, que ofrece una imagen clara de todos los ámbitos de autenticación utilizados, que las actividades necesitan para funcionar correctamente.

Todas las actividades secundarias incluidas en la actividad Ámbito de aplicación de Google Workspace se detectan automáticamente como ámbitos necesarios.

Si no se seleccionan ámbitos manualmente desde el asistente de Ámbitos, la función Detección automática se aplica de forma predeterminada en el tiempo de ejecución, y se elimina la necesidad de configurar el asistente. Todos los ámbitos mínimos necesarios se seleccionan en tiempo de ejecución.

También puedes añadir un ámbito manualmente después de añadir una actividad secundaria al Ámbito de aplicación de Google Workspace.

Nota: Para obtener más información sobre los ámbitos y permisos de la API, consulta Microsoft 365 y Google Workspace Cards: permisos y ámbitos de la API.

Autenticación

• Tipo de autenticación : una lista desplegable que especifica el tipo de autenticación que quieres utilizar para acceder a los servicios de Google Workspace. Los valores de propiedad disponibles son: ApiKey, OAuthClientID y ServiceAccountKey. Dependiendo de la selección del tipo de autenticación, pueden ser necesarios campos de propiedad adicionales.

ID de cliente de AutorizaciónO

Nota: Este es el mismo método de autenticación admitido en Integration Service, ya sea a través de la aplicación pública de UiPath o de una aplicación privada personalizada (método Trae tu propia aplicación).

Los siguientes campos de propiedad solo son necesarios si tu valor de Tipo de autenticación es OAuthClientID.

• ID de cliente: el ID de credencial para la cuenta de usuario. Esta propiedad admite variables String y valores en formato de cadena.
• Secreto de cliente : el secreto de credencial para la cuenta de usuario. Esta propiedad admite variables String y valores en formato de cadena.
• Cliente OAuth : indica la aplicación (cliente) que se utilizará. Si se selecciona UiPath, no se debe proporcionar ningún ID de cliente ni Secreto de cliente. El valor predeterminado es UiPath.
• Secreto de cliente seguro : el secreto de cliente para la cuenta de usuario, como una cadena segura. Esta propiedad admite variables String y valores en formato de cadena.
  Nota:

  Al utilizar Apps de UiPath permites que los Robots UiPath accedan a los datos en tu cuenta de correo de Google. En consecuencia, permites que los Robots de UiPath manipulen los datos únicamente de acuerdo con tus instrucciones. UiPath nunca accederá, almacenará o procesará los datos que manipules de ninguna manera mediante el uso de Robots de UiPath y no permitirá que los Robots se utilicen más allá de las instrucciones del usuario. El uso por parte de UiPath de la información recibida de las API de Google se ceñirá a la Política de datos de usuario de los servicios API de Google, incluidos los requisitos de uso limitado.

  Puedes consultar la Política de privacidad de UiPath completa para obtener más información.

• Ubicación del almacén de datos de conexión : una lista desplegable que especifica dónde se almacena el TokenResponse. Los valores de propiedad disponibles son Disco local, Orchestrator o No almacenar nunca. Esta propiedad solo es aplicable si el Tipo de autenticación seleccionado es OAuthClientID.

• Ruta de la carpeta de Orchestrator de conexión : la carpeta de Orchestrator donde se producen las operaciones. Dejar vacío si las carpetas modernas no están habilitadas. Para obtener más información, consulta Acerca de las carpetas en la Guía de Orchestrator.

• Usuario : el identificador asignado a un usuario autorizado. Se genera un token de respuesta único para cada identificador que puede almacenarse para uso futuro. Esta propiedad admite variables String y valores en formato de cadena. Esta propiedad solo es aplicable si el Tipo de autenticación seleccionado es OAuthClientID.

Clave de cuenta de servicio

Los siguientes campos de propiedad solo son necesarios si tu valor de Tipo de autenticación es Clave de cuenta de servicio.

• Tipo de clave : una lista desplegable que especifica el tipo de cuenta de servicio según el archivo de clave. Los valores de propiedad disponibles son JSON o P12. Para un tipo de cuenta de servicio P12, se requieren las propiedades Contraseña y Correo electrónico de la cuenta de servicio .
• Correo electrónico de la cuenta de servicio: la dirección de correo electrónico generada automáticamente para la cuenta de servicio. Esta propiedad admite variables String y valores en formato de cadena y solo es necesaria si tu valor de Tipo de clave es P12.
• Correo electrónico del usuario : si se selecciona Tiene acceso a todo el dominio , la cuenta de servicio suplanta a un usuario del dominio; utiliza este campo para introducir la dirección de correo electrónico del usuario suplantado.
• Tiene acceso a todo el dominio : si se selecciona, la actividad otorga acceso a todo el dominio a la cuenta de servicio. Valor booleano.
• Ruta de clave : la ruta al archivo de clave de la cuenta de servicio. Esta propiedad admite variables String y valores en formato de cadena. La creación de una cuenta de servicio en Google Cloud Platform genera un archivo clave para descargar.
• Contraseña : la contraseña de la cuenta de servicio. Esta propiedad admite variables String y valores en formato de cadena y solo es necesaria si tu valor de Tipo de clave es P12.
• Depósito de almacenamiento de claves de Orchestrator: el depósito de almacenamiento utilizado para recuperar las credenciales especificadas por Ruta de la clave. Si se selecciona un depósito de almacenamiento, el campo Ruta de la clave debe especificar la ruta del archivo en el depósito de almacenamiento seleccionado. Si no se establece un depósito de almacenamiento, la ruta de la clave utiliza un almacenamiento local. Si seleccionas el modo de entrada Ruta completa, puedes introducir la ruta del depósito de almacenamiento como una cadena o utilizar una variable.
  Nota: Con esta opción, puedes usar la autenticación de clave de cuenta de servicio en modo desatendido mucho más fácilmente. Ya no es necesario añadir el archivo P12 o JSON en la carpeta del proyecto.

Clave API

El siguiente campo de propiedad solo es necesario si tu valor de Tipo de autenticación es ClaveAPI.

• Clave API: la clave API de la cuenta. Solo puedes utilizar la clave API con las actividades de Google Sheets. Esta propiedad admite variables String y valores en formato de cadena. Si quieres utilizar las actividades de Google Mail, Google Calendar y/o Google Drive, debes seleccionar un valor de Tipo de autenticación diferente.

Común

• ContinuarEnCasoDeError : si se establece, las actividades restantes se ejecutan si la actividad actual falla.
• TimeoutMS : si se establece, la actividad agota el tiempo de espera con una excepción después del número de milisegundos establecido.

El uso del software desarrollado y proporcionado por UiPath en conexión con cualquier software de Google está sujeto al Acuerdo de licencia de actividad de UiPath Open Platform. El software y los servicios de Google usados en combinación con el software de UiPath podrán ser accedidos y utilizados de acuerdo con los Términos de Google y cualquier otro acuerdo, política o directriz aplicable puesto a su disposición por parte de Google.