Cómo utilizar IBM App Connect con Gmail

Gmail es el servicio de correo electrónico gratuito basado en web de Googleque proporciona almacenamiento para correos electrónicos, chat y archivado.

Utiliza IBM® App Connect para conectar Gmail a otras aplicaciones como Slack. Por ejemplo, cuando se reciben correos electrónicos en Gmail, se notifica inmediatamente en Slack.

Disponibilidad:
  • Un conector en IBM App Connect Enterprise as a ServiceApp Connect Enterprise as a Service conector
  • Un conector local en una instancia de Designer de IBM App Connect in containers (release de Continuous Delivery)Conector local en contenedores (release de Continuous Delivery)
  • Un conector local en una instancia de Designer de IBM App Connect in containers (Ciclo de soporte 2)Conector local en contenedores (versión Long Term Support Cycle-2 )

Versiones de producto y API soportadas

Para saber qué versiones de producto y API admite este conector, consulte Requisitos detallados del sistema en la página de asistencia IBM.

Conexión a Gmail

Complete los campos de conexión que ve en la página Conectar > Aplicaciones y API del Diseñador App Connect o en el editor de flujos. Si es necesario, trabaja con tu administrador de Gmail para obtener estos valores.

Tipos de autorización y campos de conexión de Google Analytics :

Tipo de autorización Campos de conexión Aplicabilidad
Utilice el sitio web de la aplicación para iniciar sesión (OAUTH 2.0 AUTH CODE) ID de cliente de aplicación App Connect Enterprise as a Service
Secreto de cliente de aplicación
Proporcionar credenciales para que las utilice App Connect (BASIC OAUTH) ID de cliente de aplicación App Connect Enterprise as a Service y App Connect in containers
Secreto de cliente de aplicación
Señal de acceso OAuth
Señal de renovación OAuth
La tabla siguiente contiene descripciones de los campos de conexión.
Consejo:

Para conectarse mediante el método de autorización OAuth 2.0 para sitios web, consulte Conexión a una aplicación Google mediante el método de autorización OAuth 2.0 para sitios web.

Para generar los valores para ID de cliente de aplicación, Secreto de cliente de aplicación, Señal de accesoy Renovar señal , consulte Obtención de ID de cliente OAuth, secreto de cliente, señal de acceso y señal de renovación para aplicaciones Google.
Campo de conexión Descripción
ID de cliente de aplicación El identificador exclusivo que se genera desde la consola de API de Google que se correlaciona con solicitudes de proyecto específicas.
Secreto de cliente de aplicación El secreto de cliente de aplicación para el ID de cliente de aplicación exclusivo creado para un proyecto específico.
Señal de acceso OAuth La señal de acceso que se genera a partir del ID de cliente de aplicación y el secreto de cliente.
Señal de renovación OAuth La señal de renovación que se genera a partir del ID de cliente de aplicación y el secreto de cliente.

Para conectarte a un punto final de Gmail desde la página Aplicaciones y API de App Connect Designer por primera vez, expande Gmail y, a continuación, haz clic en Conectar.

Consejo:

Antes de utilizar la cuenta creada en App Connect en un flujo, cambie el nombre de la cuenta por algo significativo que le ayude a identificarla. Para cambiar el nombre de la cuenta en la página Aplicaciones y API, seleccione la cuenta, abra su menú de opciones (⋮) y, a continuación, haga clic en Cambiar nombre de cuenta.

Qué considerar primero

Antes de utilizar App Connect Designer con Gmail, tenga en cuenta las consideraciones siguientes:
  • (Consideración general) Puede ver listas de los eventos y acciones desencadenantes que están disponibles en la página Aplicaciones y API del Diseñador de App Connect.

    Para algunas aplicaciones, los eventos y acciones dependen del entorno y de si el conector admite eventos configurables y descubrimiento dinámico de acciones. Si la aplicación da soporte a sucesos configurables, verá un enlace Mostrar más sucesos configurables bajo la lista de sucesos. Si la aplicación da soporte al descubrimiento dinámico de acciones, verá un enlace Mostrar más bajo la lista de acciones.

  • (Consideración general) Si está utilizando varias cuentas para una aplicación, el conjunto de campos que se visualiza al seleccionar una acción para esa aplicación puede variar para distintas cuentas. En el editor de flujos, algunas aplicaciones siempre proporcionan un conjunto organizado de campos estáticos para una acción. Otras aplicaciones utilizan el descubrimiento dinámico para recuperar el conjunto de campos configurados en la instancia a la que está conectado. Por ejemplo, si tiene dos cuentas para dos instancias de una aplicación, la primera cuenta puede utilizar valores que estén listos para su uso inmediato. Sin embargo, la segunda cuenta se puede configurar con campos personalizados adicionales.
  • El suceso Correo electrónico nuevo puede procesar correos electrónicos de hasta 10MB.

Adición de archivos adjuntos a Gmail

Nota: Al insertar una acción Enviar correo electrónico en un flujo, puede añadir uno o más archivos adjuntos utilizando el campo de matriz Archivos adjuntos . El tamaño total de los archivos adjuntos no puede superar los 25 MB.
  • La posibilidad de añadir adjuntos solo está disponible en una instancia de App Connect Designer 12.0.5.0-r3 o posterior para App connect en contenedores.
  • Si está utilizando App Connect Designer en contenedores y el flujo de trabajo espera cargas útiles frecuentes de gran tamaño, el valor predeterminado del límite superior de memoria para ejecutar el contenedor de designerflows puede ser demasiado bajo. Puede aumentar este valor actualizando el valor spec.integrationServer.containers.designerflows.resources.limits.memory en el recurso personalizado de Designer. Para obtener más información sobre los valores predeterminados para este parámetro, consulte Valores de recursos personalizados.

Cuando inserta una acción Enviar correo electrónico en un flujo, puede añadir uno o varios archivos adjuntos utilizando el campo de matriz Archivos adjuntos . El tamaño total de los archivos adjuntos no puede superar los 25 MB.

Para añadir un archivo adjunto en Gmail, realice los pasos siguientes:
  1. Cambie al modo Avanzado para ver el campo Archivos adjuntos.
    Vista de modo avanzado para el conector de Gmail que muestra el campo de archivos adjuntos
  2. En la modalidad avanzada, actualice los campos Archivos adjuntos, Nombre de archivoy Contenido .
    • Adjuntos: uno o más archivos para adjuntar al correo electrónico.
    • Nombre de archivo: el nombre de archivo, incluida la extensión, del archivo adjunto; por ejemplo, test.pdf, test.docxo test.txt.
    • Contenido: el contenido del archivo adjunto. Si el tipo de contenido es binario, especifique el contenido en formato Base64-encoded .
    Puede elegir rellenar estos campos utilizando distintos métodos.
    • Puede utilizar funciones JSONata para rellenar los campos. Por ejemplo:
      Ejemplo de campos de archivo adjunto rellenados utilizando funciones JSONata
    • Puede correlacionar los valores correspondientes a los campos del nodo anterior. Por ejemplo:
      Ejemplo de campos de archivo adjunto rellenados utilizando valores correlacionados del nodo anterior
    • Puede correlacionar valores correspondientes a los campos de los parámetros de cuerpo de solicitud, donde los archivos adjuntos son una matriz de objetos. Por ejemplo:
      Ejemplo de campos de archivo adjunto rellenados utilizando valores correlacionados de los parámetros de cuerpo de solicitud

Sucesos y acciones

Sucesos de Gmail

Estos sucesos son para cambios en esta aplicación que desencadenan que un flujo empiece a completar las acciones en el flujo.

Nota: En los contenedores, sólo se pueden utilizar cuentas locales para estos sucesos.
Suceso Descripción
Nuevo correo electrónico Se activa cuando se crea un mensaje de correo electrónico

Acciones de Gmail

El flujo completa estas acciones en esta aplicación.

Objecto Acción Descripción
Correos electrónicos Suprimir correo electrónico Elimina un mensaje de correo electrónico
Recuperar correos electrónicos Recupera mensajes de correo electrónico de Gmail
Enviar correo electrónico Envía un mensaje de correo electrónico desde Gmail
Actualizar etiquetas de correo electrónico Actualiza la etiqueta de un mensaje moviendo el mensaje dentro o fuera de una etiqueta

Ejemplos

Para ver ejemplos de utilización de Gmail en flujos, consulte los recursos siguientes:
Mosaico de panel de control para una plantilla que utiliza Gmail
Mosaico de panel de control para una plantilla que utiliza Gmail
Mosaico de panel de control para una plantilla que utiliza Gmail

Utilice plantillas para crear rápidamente flujos para Gmail.

Aprenda a utilizar plantillas de App Connect para crear flujos que conecten Gmail con otras aplicaciones. Por ejemplo, abre Discover y, a continuación, busca Gmail.