Gmail — Get labels

Gmail — Get labels

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

Lista las etiquetas del buzón (las del sistema como INBOX o UNREAD y las personalizadas). Úsala para descubrir el ID de una etiqueta antes de filtrar con labelIds, o para comprobar que una etiqueta existe antes de aplicarla.

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.

Devuelve todas las etiquetas en una sola llamada; no modifica nada.

Parámetros requeridos

Ninguno.

Parámetros opcionales

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

Salida

Devuelve un List<Dictionary<string,object>>: un elemento por etiqueta, con estas claves.

Clave	Tipo	Contenido
id	string	ID de la etiqueta. Las de sistema usan su nombre (INBOX, SENT, UNREAD, STARRED, IMPORTANT, SPAM, TRASH, CATEGORY_PROMOTIONS…); las personalizadas, un ID como Label_123.
name	string	Nombre visible. Las anidadas incluyen la ruta: Proveedores/Facturas.
type	string	system o user.

Recórrela con un For each y accede por clave, por ejemplo etiqueta["name"] o etiqueta["id"].

Errores comunes

Mensaje	Causa y solución
No hay una sesión de Gmail disponible. …	No pasaste session y la actividad no está dentro del body de Connect.

Ejemplo

Buscar el ID de una etiqueta por su nombre y usarlo como filtro:

Gmail — Connect   credential = credential("gmail-soporte")
 └─ body:
      Gmail — Get labels   → output: etiquetas
      For each   etiqueta in etiquetas
       └─ If   condition = str(etiqueta["name"]) == "Proveedores"
           └─ Set Variable   name = idProveedores   value = etiqueta["id"]
      Gmail — Get emails   labelIds = idProveedores   query = "is:unread"   → output: correos

Actividades relacionadas

• Gmail — Apply label — aplicar una etiqueta.
• Gmail — Remove label — quitar una etiqueta.
• Gmail — Get emails — filtrar por etiqueta con labelIds.
• Todas las actividades de Gmail