Gmail — Apply label

Tipo: gmail-apply-label · Paquete: Gmail v1.0.4 · Salida: —

Aplica una o varias etiquetas a un correo. En Gmail las etiquetas hacen las veces de carpetas: úsalas para clasificar los correos que tu proceso ya atendió (p. ej. Procesado) y separarlos de los pendientes.

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.

Indica las etiquetas por nombre (p. ej. Procesado, o Proveedores/Facturas para una etiqueta anidada; sin distinguir mayúsculas) o por ID (STARRED, IMPORTANT, Label_123…). Consulta nombres e IDs con Get labels.
Las etiquetas deben existir en el buzón: la actividad no las crea. Créalas una vez en Gmail.
Antes de modificar nada, resuelve todas las etiquetas: si una no existe, falla sin aplicar ninguna.
Conserva las etiquetas que el correo ya tenía. Aplicar una que ya tiene no cambia nada ni falla.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`id`	`string`	—	ID del mensaje.
`labels`	`string \| List`	—	Nombre(s) o ID(s) de etiqueta a aplicar: texto separado por comas o punto y coma, o una lista.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanGmailSession`	—	Sesión de Gmail — Connect (se hereda dentro del `body`).

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
`No se encontró la etiqueta. Usa el nombre o el ID de una etiqueta existente.`	Alguna etiqueta no existe en el buzón (o tiene otro nombre). Créala en Gmail o revisa el nombre con Get labels.
`'labels' es obligatorio.`	`labels` está vacío.
`'id' es obligatorio.`	`id` está vacío o la expresión devolvió `null`.
`Requested entity was not found.`	No hay un correo con ese ID en el buzón.

Ejemplo

Gmail — Connect   credential = credential("gmail-soporte")
 └─ body:
      Gmail — Get emails   query = "is:unread -label:Procesado"   → output: nuevos
      For each   correo in nuevos
       └─ Gmail — Download attachments   id = correo["id"]   folder = "C:\entrada"
          Gmail — Apply label   id = correo["id"]   labels = "Procesado"

Actividades relacionadas

Gmail — Remove label — quitar una etiqueta.
Gmail — Get labels — listar las etiquetas del buzón.
Gmail — Get emails — localizar los correos a etiquetar.
Todas las actividades de Gmail