Conexión de Google Drive
Introducción
Una conexión de Google Drive, creada utilizando el conector de Google Drive, establece acceso a Google Drive. Una vez que se configura una conexión, se pueden crear instancias de actividades de Google Drive 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 Drive, 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 Drive 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 Drive.
La carpeta de Google Drive a la que deseas acceder debe estar compartida con la cuenta de servicio de Google que se utiliza en la conexión. No se puede acceder a documentos fuera de la carpeta compartida.
Crear o editar una conexión de Google Drive
Se crea una nueva conexión de Google Drive utilizando el conector de Google Drive 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 Drive 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 en el 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 Drive
Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Google Drive 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ú que enumera 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 Drive y no debe contener barras diagonales
/ni dos puntos:. Este nombre también se utiliza para identificar el punto final de Google Drive, 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 OAuth: Seleccione una aplicación de conector de Google Drive configurada en la página de Registros 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 Drive en la página de Registros 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 Drive.
-
-
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_idproporcionado por el archivo JSON de credenciales de la cuenta de servicio. -
Correo electrónico del cliente: Ingrese el
client_emailproporcionado por el archivo JSON de credenciales de la cuenta de servicio. -
Cadena de clave privada: Ingrese la
private_keyproporcionada por el archivo JSON de credenciales de la cuenta de servicio. La clave privada debe ingresarse en este formato:-----BEGIN PRIVATE KEY----- <private_key> -----END PRIVATE KEY-----Nota
Todos los caracteres de nueva línea (
\n) presentes en la cadenaprivate_keydeben 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 Drive, 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:
-
Actualizar archivo: Actualiza archivos en Google Drive y está destinado a ser utilizado como un destino en una operación.
-
Eliminar archivo: Elimina un archivo de Google Drive y está destinado a ser utilizado como un destino en una operación.
-
Crear archivo: Crea archivos en Google Drive y está destinado a ser utilizado como un destino en una operación.
-
Listar archivos: Recupera una lista de archivos (que coinciden con una consulta) de Google Drive y está destinado a ser utilizado como una fuente en una operación.
-
Obtener archivo: Recupera un archivo de Google Drive y está destinado a ser utilizado como una fuente en una operación.