Gmail — Get emails

Tipo: gmail-get-emails · Paquete: Gmail v1.0.0 · Salida: List<Dictionary<string,object>>

Busca correos en el buzón usando la sintaxis de búsqueda de Gmail y devuelve la lista de mensajes que coinciden. Es la actividad con la que normalmente arranca un proceso: localiza los correos a procesar y luego iteras sobre ellos.

Cómo funciona

Opera sobre la sesión creada con Gmail — Connect. Pásala en el parámetro session, o coloca esta actividad dentro del body de Gmail — Connect para heredarla automáticamente.

query acepta la misma sintaxis que la caja de búsqueda de Gmail (is:unread, from:, subject:, has:attachment, after:/before:…). Por defecto no trae el cuerpo de cada correo (es más rápido); activa includeBody si necesitas el texto y la información de adjuntos en el mismo paso.

Parámetros requeridos

Ninguno.

Parámetros opcionales

Parámetro	Editor	Descripción
`session`	expresión	Sesión de Gmail — Connect (se hereda dentro del `body`).
`query`	texto	Búsqueda de Gmail (misma sintaxis que la caja del buzón). Vacío = todo el correo. Ej.: `is:unread from:jefe@acme.com`.
`maxResults`	texto	Número máximo de correos a devolver. Por defecto 25.
`includeBody`	booleano	Si es `true`, incluye el cuerpo y los adjuntos de cada correo (más lento). Por defecto `false`.
`labelIds`	expresión	Restringe a una o varias etiquetas por ID (p. ej. `INBOX`, `UNREAD`). Separadas por comas o como lista.

Salida

Devuelve un List<Dictionary<string,object>>: una lista en la que cada elemento es un correo. Cada correo trae las claves id, threadId, from, to, subject, date, snippet, labels y unread (y, con includeBody, también body, bodyHtml y attachments).

Recorre la lista con un For each y accede a cada campo por su clave, por ejemplo correo["subject"] o correo["from"]. Usa el id como entrada de Get email by ID, Reply o Apply label.

Ejemplo

Gmail — Connect   credential = "gmail-soporte"
 └─ body:
      Gmail — Get emails   query = "is:unread has:attachment"   maxResults = "50"   → output: pendientes
      For each   correo in pendientes
       └─ Gmail — Download attachments   id = correo["id"]   folder = "C:\\adjuntos"

Actividades relacionadas

Gmail — Connect — abrir la sesión.
Gmail — Get email by ID — traer un correo completo.
Gmail — Download attachments — guardar los adjuntos de un correo.
Todas las actividades de Gmail