Saltar al contenido

Conexión de Google Docs en Jitterbit Studio

Introducción

Una conexión de Google Docs, creada utilizando el conector de Google Docs, establece acceso a Google Docs. Una vez que se configura una conexión, se pueden crear instancias de actividades de Google Docs 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 Docs, 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 Docs sin 3LO, debe tener una cuenta de servicio de Google para su proyecto con los permisos apropiados establecidos y ciertas credenciales obtenidas de la cuenta de servicio como se describe en los prerrequisitos de Google Docs.

Crear o editar una conexión de Google Docs

Se crea una nueva conexión de Google Docs utilizando el conector de Google Docs desde una de estas ubicaciones:

Una conexión de Google Docs existente se puede editar desde estas ubicaciones:

Configurar una conexión de Google Docs

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Google Docs 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 Docs y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de Google Docs, 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 utilizar OAuth 2.0 de 3 patas (3LO) para la autenticación. Para notas importantes sobre el comportamiento del token de acceso y el token de actualización, consulte Notas importantes.

      • Aplicación de OAuth: Seleccione una aplicación de conector de Google Docs 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 Docs 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 del navegador separada y otorgue consentimiento para que Jitterbit acceda a la aplicación de Google Docs.

  • 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 de la [cuenta de servicio](/es/integration-studio/design/connectors/google-docs/prerequisites/#service-account).

-   **Correo electrónico del cliente:** Ingrese el `client_email` proporcionado por el archivo JSON de credenciales de la [cuenta de servicio](/es/integration-studio/design/connectors/google-docs/prerequisites/#service-account).

-   **Cadena de clave privada:** Ingrese la `private_key` proporcionada por el archivo JSON de credenciales de la [cuenta de servicio](/es/integration-studio/design/connectors/google-docs/prerequisites/#service-account). La clave privada debe ingresarse en este formato:

    ```
    -----BEGIN PRIVATE KEY-----
    <private_key>
    -----END PRIVATE KEY-----
    ```

    !!! note "Nota"
        Todos los caracteres de nueva línea (`\n`) presentes en la cadena `private_key` deben ser reemplazados por un retorno de carro en el campo **Cadena de clave privada**. De lo contrario, ocurrirá un error al probar la conexión.

  • Probar: 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.

Próximos pasos

Después de que se ha creado una conexión de Google Docs, 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, consulta los menús de acciones en Conceptos básicos de conectores.

Estos tipos de actividad están disponibles:

  • Crear Docs: Crea documentos y los coloca en Google Docs y está destinado a ser utilizado como un destino en una operación.

  • Actualizar Docs: Actualiza documentos de Google Docs y está destinado a ser utilizado como un destino en una operación.

  • Obtener Docs: Recupera documentos de Google Docs y está destinado a ser utilizado como una fuente en una operación.