Gmail — Delete

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

Elimina un correo. Por defecto lo mueve a la papelera (recuperable); con permanent lo borra de forma definitiva.

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 el correo va a la papelera, donde Gmail lo conserva unos 30 días antes de borrarlo; mientras tanto se puede recuperar. Su id sigue existiendo y lo encuentras con in:trash.
Con permanent = true se borra en el acto, sin pasar por la papelera. Para esto la conexión necesita el alcance completo de Gmail (https://mail.google.com/); con alcances más limitados, Gmail lo rechaza.

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`).
`permanent`	`bool`	`false`	Si es `true`, borra de forma permanente (no se puede deshacer); si es `false`, mueve a la papelera.

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 (por ejemplo, ya se borró de forma permanente). En lotes que se reintentan, envuelve la actividad en un Try/Catch.
`Request had insufficient authentication scopes.`	Usaste `permanent = true` y la conexión no tiene el alcance `https://mail.google.com/`. Agrégalo a la conexión o usa la papelera.

Ejemplo

Gmail — Connect   credential = credential("gmail-soporte")
 └─ body:
      Gmail — Get emails   query = "older_than:1y category:promotions"   maxResults = 100   → output: viejos
      For each   correo in viejos
       └─ Gmail — Delete   id = correo["id"]

Actividades relacionadas

Gmail — Get emails — localizar los correos a eliminar.
Gmail — Archive — sacar de la bandeja sin borrar.
Gmail — Apply label — etiquetar en vez de borrar.
Todas las actividades de Gmail