Crea y configura una conexión de Google Drive

En esta página, se describe cómo crear y configurar una conexión de Google Drive en Integration Connectors. Para obtener más información sobre el conector de Google Drive, consulta la Descripción general del conector de Google Drive.

Antes de comenzar

En tu proyecto Google Cloud, realiza las siguientes tareas:

  • Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
  • Otorga el rol de IAM roles/connectors.admin al usuario que configura el conector.
  • Otorga los roles de IAM roles/secretmanager.viewer y roles/secretmanager.secretAccessor a la cuenta de servicio que deseas usar para el conector.
  • Habilita los siguientes servicios:
    • secretmanager.googleapis.com (API de Secret Manager)
    • connectors.googleapis.com (API de conectores)

    Para comprender cómo habilitar servicios, consulta Habilita servicios. Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

Crea una conexión de Google Drive

Para crear una conexión de Google Drive, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Integration Connectors > Connections.

    Ir a Conexiones

  2. Haz clic en Crear conexión.

    Aparecerá la página Create Connection.

  3. En la sección Ubicación, haz lo siguiente:
    1. Haz clic en Región y, luego, selecciona una ubicación para tu conexión.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

    2. Haz clic en Siguiente.
  4. En la sección Detalles de la conexión, proporciona los siguientes detalles:
    1. Conector: Selecciona Google Drive.
    2. Versión del conector: Selecciona la versión del conector que deseas usar.

      La versión del conector que selecciones dependerá de la versión de la API de Google Drive que quieras usar. Para obtener más información, consulta Versiones de conexión de Google Drive.

    3. Nombre de la conexión: Ingresa un nombre para la conexión.
    4. Descripción: Ingresa una descripción para la conexión (opcional).
    5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
    6. Cuenta de servicio: Selecciona la cuenta de servicio que deseas usar para la conexión. Asegúrate de que la cuenta de servicio tenga los roles y permisos de IAM pertinentes necesarios.
    7. Supports All Drives: Selecciona esta casilla de verificación para habilitar el acceso a las unidades compartidas. Esta opción solo está disponible para Google Drive v2.
    8. Configuración del nodo de conexión: (Opcional) Configura los parámetros del nodo de conexión.
      • Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
      • Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.

      Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, de forma predeterminada, los nodos mínimos se establecen en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.

    9. Haz clic en Siguiente.
  5. En la sección Autenticación, selecciona y configura el tipo de autenticación para la conexión:

    Cuenta de servicio

    Selecciona esta opción si tu aplicación se ejecuta en una máquina virtual de Google Cloud y debe usar la cuenta de servicio adjunta de la VM para la autenticación.

    Para usar este tipo de autenticación, debes tener una cuenta de servicio con los roles y permisos de IAM relevantes necesarios para la autenticación.

    Para obtener información sobre cómo crear una cuenta de servicio, consulta Crea y administra cuentas de servicio. Para obtener información sobre cómo otorgar roles a una cuenta de servicio, consulta Cómo otorgar, cambiar y revocar el acceso a los recursos.

    Detalles de conexión de ejemplo para el tipo de autenticación de cuenta de servicio

    Nombre del campo Detalles
    Ubicación us-central1
    Conector Google Drive
    Versión del conector 2
    Nombre de la conexión googledrive-ws-gcpaccount
    Habilita Cloud Logging Sí
    Cuenta de servicio 123456789012-compute@developer.gserviceaccount.com
    Cantidad mínima de nodos 2
    Cantidad máxima de nodos 50
    Autenticación Autenticación de cuenta de servicio

    OAuth 2.0, portador de JWT

    Para configurar el tipo de autenticación con portador de JWT de OAuth 2.0, haz lo siguiente:

    1. Crea una clave JSON de cuenta de servicio y descarga el archivo de claves JSON. Este archivo de clave se usa como certificado JWT para la conexión.
    2. Crea un secreto para almacenar el archivo de claves JSON o el certificado JWT.
    3. Proporciona los detalles del secreto cuando crees la conexión en Integration Connectors:
      • Certificado JWT: Elige el secreto que contiene el certificado JWT.
      • Versión del secreto: Selecciona la versión del secreto seleccionado.
      • Asunto del JWT: (Opcional) Ingresa el asunto del JWT que se usará para la conexión. Se usa como el campo sub en el token JWT.

    Detalles de conexión de ejemplo para el tipo de autenticación con portador de JWT de OAuth 2.0

    Nombre del campo Detalles
    Ubicación us-central1
    Conector Google Drive
    Versión del conector 2
    Nombre de la conexión googledrivejwt
    Habilita Cloud Logging Sí
    Cuenta de servicio 123456789012-compute@developer.gserviceaccount.com
    Cantidad mínima de nodos 2
    Cantidad máxima de nodos 50
    Autenticación OAuth 2.0, portador de JWT
    Certificado JWT 
    {
  "type": "service_account",
  "project_id": "sm****-****-******",
  "private_key_id": "0b***************************",
  "private_key": "-----BEGIN PRIVATE KEY-----\nO********************************************=\n-----END PRIVATE KEY-----\n",
  "client_email": "go**********************************8",
  "client_id": "10**********************",
  "auth_uri": "https:***********************",
  "token_uri": "https:************************",
  "auth_provider_x509_cert_url": "https:*********************",
  "client_x509_cert_url": "https:****************************************************",
  "universe_domain": "go********"
}
    Versión del Secret 2

    Código de autorización de OAuth 2.0

    Usa este método si tu aplicación requiere la interacción del usuario final a través de un acceso basado en el navegador.

    Para configurar el tipo de autenticación de código de autorización de OAuth 2.0, haz lo siguiente:

    1. Crea credenciales de OAuth 2.0 para tu aplicación web. Este proceso crea un ID de cliente y el archivo JSON del secreto del cliente.
    2. Identifica los permisos de acceso que deseas otorgar a tu aplicación.
    3. Crea un secreto para almacenar las credenciales de OAuth 2.0 (client_secret.json).
    4. Proporciona el ID de cliente, los alcances y los detalles del secreto cuando crees la conexión en Integration Connectors:
      • ID de cliente: Ingresa el ID de cliente creado para tu aplicación web.
      • Scopes: Ingresa una lista separada por comas de los permisos deseados.
      • Secreto del cliente: Elige el secreto que contiene las credenciales de OAuth 2.0.
      • Versión del secreto: Selecciona la versión del secreto seleccionado.

    Detalles de conexión de muestra para el tipo de autenticación de código de autorización de OAuth 2.0

    Nombre del campo Detalles
    Ubicación europe-west1
    Conector Google Drive
    Versión del conector 2
    Nombre de la conexión googledrive-wsconn-code
    Habilita Cloud Logging Sí
    Cuenta de servicio 123456789012-compute@developer.gserviceaccount.com
    Cantidad mínima de nodos 2
    Cantidad máxima de nodos 50
    Autenticación Código de autorización de OAuth 2.0
    ID de cliente CLIENT_ID
    Permisos https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/drive.appdata, https://www.googleapis.com/auth/drive.appfolder, https://www.googleapis.com/auth/drive.install, https://www.googleapis.com/auth/drive.metadata, https://www.googleapis.com/auth/drive.metadata.readonly, https://www.googleapis.com/auth/drive.activity, https://www.googleapis.com/auth/drive.activity.readonly, https://www.googleapis.com/auth/drive.apps.readonly, https://www.googleapis.com/auth/drive.scripts y https://www.googleapis.com/auth/drive.meet.readonly
    Secreto del cliente CLIENT_SECRET
    Versión del Secret 2
  6. Habilitar la anulación de la autenticación: (Opcional) Selecciona esta casilla de verificación para habilitar la conexión y aceptar una autenticación diferente de forma dinámica durante el tiempo de ejecución.
  7. Haz clic en Siguiente.
  8. En la sección Revisar, revisa los detalles de conexión y autenticación. Siempre puedes hacer clic en cualquiera de las secciones anteriores para realizar los cambios necesarios.
  9. Haz clic en Crear.

    Integration Connectors comienza a crear la conexión para la configuración proporcionada. Este proceso tarda unos minutos en completarse. Después de crear la conexión, se te redireccionará a la página Conexiones.

Usa la conexión de Google Drive en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en Application Integration. Puedes usar la conexión en una integración a través de la tarea Connectors.

  • Para comprender cómo crear y usar la tarea Connectors en Apigee Integration, consulta Tarea Connectors.
  • Para comprender cómo crear y usar la tarea Connectors en Application Integration, consulta Tarea Connectors.

Para obtener la lista de entidades y operaciones compatibles, consulta Entidades y operaciones compatibles. Para obtener información sobre las acciones específicas del conector compatibles, consulta Acciones compatibles.

Ejemplos de casos de uso en Application Integration

En los siguientes ejemplos, se muestra cómo usar la tarea Connectors en Application Integration para realizar operaciones con tu conexión configurada de Google Drive.

Ejemplo: Enumera todos los archivos

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Files en la lista Entity.
  3. Selecciona la operación List y haz clic en Listo.
  4. En la sección Entrada de tarea de la tarea Conectores, puedes establecer la cláusula de filtro según los requisitos del cliente.

    5. El valor de filterClause siempre debe pasarse entre comillas simples (') en este formato.

    Puedes usar filterClause para filtrar un determinado conjunto de registros según cualquier columna.

Ejemplo: Obtén los detalles de un archivo

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Files en la lista Entity.
  3. Selecciona la operación Get y haz clic en Listo.
  4. Establece el entityId en "1wsHFAusizqFe5O2", que es la clave que se pasará. Para establecer el entityId, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "1wsHFAusizqFe5O2" en el campo Input Value y elige entityId como variable local.

    5. El valor de entityId se debe pasar directamente, por ejemplo, "1wsHFAusizqFe5O2". Aquí, "1wsHFAusizqFe5O2" es el valor de clave primaria único que se pasa.

Ejemplo: Borra un archivo

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Files en la lista Entity.
  3. Selecciona la operación Delete y haz clic en Listo.
  4. Establece el entityId en "1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L", que es la clave que se pasará. Para establecer el entityId, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L" en el campo Input Value y elige entityId como variable local.

    5. Si la entidad tiene dos claves comerciales o primarias compuestas, en lugar de especificar el entityId, también puedes establecer el filterClause en id='1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L'.

Ejemplo: Crea un archivo

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Files en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige entityId/connectorInputPayload como variable local.
    5.   { "FileData": " ",
  "Name": "creategcpshareddrivedocxfile.docx", 
  "MIMEType": "application/vnd.google-apps.document",
  "Encoding": "BASE64"}

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

    { "Id": "1C48uLda6lyeakx2hOUdwnib-qtFOAhlpR_Ja2AmPvTU"}

Ejemplo: Crea una unidad compartida

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Drives en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige entityId/connectorInputPayload como variable local.
    5.   {"Name": "SharedDrive7"}

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

      {"Id": "0AN6y5wEvVrmPUk9PVA"}

Ejemplo: Crea un permiso para un archivo, una carpeta o una unidad compartida

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Permissions en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige entityId/connectorInputPayload como variable local.
    5.   {"ResourceId": "1PErCmc9MmnYzcslo49DeIIN1-ACs3W4L",
  "Role": "COMMENTER",
  "Type": "USER",
  "EmailAddress": "charlie@altostrat.com"}

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

      { "PermissionId": "10596783046483894074",
  "ResourceId": "1PErCmc9MmnYzcslo49DeIIN1-ACs3W4L"}

Ejemplo: Actualiza los detalles de un archivo

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Files en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige entityId/connectorInputPayload/filterClause como variable local. 
      {"Name": "New Updated file"}
  5. Establece el entityId del archivo. Para establecer el entityId, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige entityId/connectorInputPayload/filterClause como variable local.

    En lugar de especificar entityId, también puedes establecer filterClause en 1IY5YhQN-LRgR3IxKlheqXM83sJP3DMFm.

    6. Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {"Id": "1IY5YhQN-LRgR3IxKlheqXM83sJP3DMFm">}

Ejemplo: Actualiza un permiso para un archivo, una carpeta o una unidad compartida

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Permissions en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige entityId/connectorInputPayload/filterClause como variable local.
    5. (PermissionId='10596783046483894074' and ResourceId='0AKfRSSy6kZbfUk9PVA')
{ "Role": "READER"}
  5. Establece el entityId del permiso. Para establecer el entityId, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige entityId/connectorInputPayload/filterClause como variable local.

    Como alternativa, en lugar de especificar entityId, también puedes establecer filterClause en PermissionId='10596783046483894074' and ResourceId='0AKfRSSy6kZbfUk9PVA'.

    Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

      {"PermissionId": "10596783046483894074",
  "ResourceId": "0AKfRSSy6kZbfUk9PVA"}