Gmail — Archive

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

Archiva un correo: lo saca de la bandeja de entrada sin borrarlo. El correo sigue en Todos los mensajes, con sus etiquetas, y aparece en las búsquedas. Es la forma habitual de dejar la bandeja limpia después de procesar un correo, sin perder el rastro.

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.

Por defecto archiva el correo (le quita la etiqueta INBOX). Activa unarchive para hacer lo contrario: devolverlo a la bandeja de entrada (le pone INBOX). Es idempotente: archivar un correo ya archivado no cambia nada ni falla. El id del correo no cambia, así que puedes seguir operando sobre él después.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`id`	`string`	—	ID del mensaje.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanGmailSession`	—	Sesión de Gmail — Connect (se hereda dentro del `body`).
`unarchive`	`bool`	`false`	Si es `true`, devuelve el correo a la bandeja de entrada; si es `false`, lo archiva.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
`'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

Procesar las solicitudes nuevas, etiquetarlas y sacarlas de la bandeja:

Gmail — Connect   credential = credential("gmail-soporte")
 └─ body:
      Gmail — Get emails   query = "in:inbox subject:solicitud"   → output: solicitudes
      For each   correo in solicitudes
       └─ Gmail — Apply label   id = correo["id"]   labels = "Procesados"
          Gmail — Archive       id = correo["id"]

Actividades relacionadas

Gmail — Apply label — etiquetar el correo antes de archivarlo.
Gmail — Mark read/unread — marcarlo como leído.
Gmail — Delete — mandarlo a la papelera.
Todas las actividades de Gmail