Gmail — Connect

Gmail — Connect

Tipo: gmail-connect  ·  Paquete: Gmail v1.0.0  ·  Salida: ZoanGmailSession

Abre una sesión autenticada con Gmail. Es el punto de partida obligatorio del paquete: todas las demás actividades (enviar, buscar, responder, etiquetar…) trabajan sobre esta sesión, que representa el acceso a un buzón concreto.

Cómo funciona

Se autentica con una conexión OAuth de Google de Nexus (o un service account) y abre la sesión sobre el buzón. Tiene dos formas de uso:

• Con body: las actividades que coloques dentro heredan la sesión automáticamente y se ejecutan sobre ese buzón; al terminar el bloque, la sesión se cierra sola.
• Sin body: devuelve la sesión como salida; guárdala en una variable, pásala por el parámetro session a las demás actividades y ciérrala al final con Gmail — Close.

Autenticación

Dos modos en authType: oauth (por defecto — conexión OAuth de Nexus) o service-account (llave JSON guardada como credencial + impersonateUser para domain-wide delegation). El Designer muestra solo los campos del modo elegido.

Parámetros requeridos

Ninguno.

Parámetros opcionales

Parámetro	Editor	Descripción
authType	lista de opciones	Modo de autenticación: oauth (por defecto) o service-account.
credential	credencial	Modo OAuth: nombre de la conexión OAuth de Google configurada en Nexus.
serviceAccount	credencial	Modo service account: credencial con el JSON completo de la llave.
impersonateUser	texto	Modo service account: email del buzón del Workspace sobre el que operar (domain-wide delegation). Obligatorio con service account.

Sub-flujos

body opcional

Actividades a ejecutar dentro de la sesión. Heredan la sesión automáticamente y, al terminar, esta se cierra.

Salida

Devuelve un ZoanGmailSession. Si usas body no necesitas la salida (la sesión se hereda sola). Si trabajas sin body, asígnala a una variable con el campo output y pásala como session a las demás actividades.

Ejemplo

Gmail — Connect   credential = "gmail-soporte"
 └─ body:
      Gmail — Get emails   query = "is:unread"   → output: nuevos
      Gmail — Send   to = "cliente@correo.com"   subject = "Recibido"   body = "Gracias por tu mensaje."

Búsqueda potente

Get emails usa la misma sintaxis que la caja de búsqueda de Gmail (is:unread, from:jefe@acme.com, has:attachment, after:2026/01/01). Para procesos desatendidos sin consentimiento interactivo de un usuario, usa service account + impersonateUser.

Actividades relacionadas

• Gmail — Send — enviar un correo.
• Gmail — Get emails — buscar correos.
• Gmail — Close — cerrar la sesión (modo sin body).
• Todas las actividades de Gmail