Conexión de Google Sheets
Introducción
Una conexión de Google Sheets, creada utilizando el conector de Google Sheets, establece acceso a Google Sheets. Una vez que se configura una conexión, se pueden crear instancias de actividades de Google Sheets asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).
Nota
Para usar la autenticación OAuth 2.0 de 3 patas (3LO) o la autenticación de cuenta de servicio de Google Cloud con el conector de Google Sheets, se requieren prerrequisitos adicionales. Se requiere la versión 10.83 / 11.21 o posterior del agente para usar 3LO.
Para usar el conector de Google Sheets sin 3LO, debes tener una cuenta de servicio de Google para tu proyecto con los permisos apropiados establecidos, y ciertas credenciales obtenidas de la cuenta de servicio como se describe en los prerrequisitos de Google Sheets.
Crear o editar una conexión de Google Sheets
Se crea una nueva conexión de Google Sheets utilizando el conector de Google Sheets desde una de estas ubicaciones:
- La pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
- La página de Puntos finales globales (ver Crear un punto final global en Puntos finales globales).
Una conexión de Google Sheets existente se puede editar desde estas ubicaciones:
- La pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
- La pestaña Componentes del panel del proyecto (ver Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).
- La página de Puntos finales globales (ver Editar un punto final global en Puntos finales globales).
Configurar una conexión de Google Sheets
Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Google Sheets se describe a continuación.
Consejo
Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes de las que elegir.
-
Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Google Sheets y no debe contener barras diagonales
/ni dos puntos:. Este nombre también se utiliza para identificar el punto final de Google Sheets, que se refiere tanto a una conexión específica como a sus actividades. -
Tipo de autenticación: Seleccione el método de autenticación, ya sea OAuth o Basado en clave privada (predeterminado).
-
OAuth: Seleccione esta opción para usar OAuth 2.0 de 3 patas (3LO) para la autenticación:
-
Aplicación de OAuth: Seleccione una aplicación de conector de Google Sheets configurada en la página de Registro de aplicaciones de la Consola de administración. Para obtener más información sobre cómo configurar una aplicación de conector de Google Sheets en la página de Registro de aplicaciones, consulte los requisitos previos de OAuth 2.0 de 3 patas (3LO).
-
Iniciar sesión con cuenta de Google: Haga clic para autenticar a través de Google en una pestaña de navegador separada y otorgue consentimiento para que Jitterbit acceda a la aplicación de Google Sheets.
-
-
-
Basado en clave privada: Seleccione esta opción para usar una cuenta de servicio de Google Cloud para la autenticación.
- **ID del proyecto:** Ingrese el `project_id` proporcionado por el archivo JSON de credenciales como se describe en los [requisitos previos de Google Sheets](/es/integration-studio/design/connectors/google-sheets/prerequisites/#service-account). - **Correo electrónico del cliente:** Ingrese el `client_email` proporcionado por el archivo JSON de credenciales como se describe en los [requisitos previos de Google Sheets](/es/integration-studio/design/connectors/google-sheets/prerequisites/#service-account). - **Cadena de clave privada:** Ingrese el `private_key` proporcionado por el archivo JSON de credenciales como se describe en los [requisitos previos de Google Sheets](/es/integration-studio/design/connectors/google-sheets/prerequisites/#service-account). - **Algoritmo de clave:** Desde el menú, seleccione el algoritmo de cifrado de la cadena de clave privada. Actualmente, solo se admite **RSA**. -
Configuraciones opcionales: Haga clic para expandir configuraciones adicionales:
-
Tiempo de espera de conexión (milisegundos): Especifique el tiempo de espera para la conexión (en milisegundos). El valor máximo permitido es
3600000milisegundos (1 hora). El valor predeterminado es20000milisegundos (20 segundos). -
Tiempo de espera de lectura (milisegundos): Especifique el tiempo de espera de la solicitud para la actividad Obtener hojas (en milisegundos). El valor máximo permitido es
3600000milisegundos (1 hora). El valor predeterminado es20000milisegundos (20 segundos).
-
-
Prueba: Haga clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar actualización automática del conector.
-
Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.
-
Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.
-
Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.
Siguientes pasos
Después de que se ha creado una conexión de Google Sheets, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).
Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Menús de acciones en Conceptos básicos del conector.
Estos tipos de actividad están disponibles:
-
Obtener hojas: Recupera una hoja de cálculo de Google Sheets y está destinada a ser utilizada como fuente en una operación.
-
Actualizar hojas: Actualiza una hoja de cálculo de Google Sheets y está destinada a ser utilizada como destino en una operación.
-
Crear hojas: Crea una hoja de cálculo y la coloca en Google Sheets y está destinada a ser utilizada como destino en una operación.