Gmail — Remove label

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

Quita una o varias etiquetas de un correo. Es la operación inversa de Apply label: úsala, por ejemplo, para retirar Pendiente cuando el caso se resuelve.

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 (sin distinguir mayúsculas) o por ID; consúltalas con Get labels.
Cada etiqueta debe existir en el buzón; si una no existe, falla sin quitar ninguna.
Quitar una etiqueta que el correo no tiene no cambia nada ni falla.
Las etiquetas de sistema también se pueden quitar: INBOX equivale a archivar y UNREAD a marcar como leído.

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 quitar: 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. 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 = "label:Pendiente subject:resuelto"   → output: resueltos
      For each   correo in resueltos
       └─ Gmail — Remove label   id = correo["id"]   labels = "Pendiente"
          Gmail — Apply label    id = correo["id"]   labels = "Resuelto"

Actividades relacionadas

Gmail — Apply label — aplicar una etiqueta.
Gmail — Get labels — listar las etiquetas del buzón.
Gmail — Get emails — localizar los correos.
Todas las actividades de Gmail