Puedes usar etiquetas para etiquetar, organizar y categorizar mensajes y conversaciones en Gmail. Una etiqueta tiene una relación de varios a varios con los mensajes y las conversaciones: puedes aplicar varias etiquetas a un solo mensaje o conversación, y una sola etiqueta a varios mensajes o conversaciones.
Para obtener información sobre cómo create, obtener, enumerar, actualizar o borrar etiquetas, consulta la referencia de etiquetas.
Para administrar etiquetas, debes usar el permiso https://www.googleapis.com/auth/gmail.labels. Para obtener más información sobre los permisos, consulta Información de autorización y autenticación específica de la API de Gmail.
Tipos de etiquetas
Las etiquetas se dividen en dos tipos: etiquetas SYSTEM reservadas y etiquetas USER personalizadas.
Por lo general, las etiquetas del sistema corresponden a elementos predefinidos en la interfaz web de Gmail, como la carpeta Recibidos. Los nombres de las etiquetas de los sistemas están reservados. No se puede crear ninguna etiqueta USER con el mismo nombre que una etiqueta SYSTEM. En la siguiente tabla, se enumeran algunas de las etiquetas del sistema de Gmail más comunes:
| Nombre | Se puede aplicar de forma manual | Notas |
|---|---|---|
INBOX |
sí | |
SPAM |
sí | |
TRASH |
sí | |
UNREAD |
sí | |
STARRED |
sí | |
IMPORTANT |
sí | |
SENT |
no | Se aplica automáticamente a los mensajes que se envían con drafts.send o messages.send, se insertan con messages.insert y el correo electrónico del usuario en el encabezado From, o que el usuario envía a través de la interfaz web. |
DRAFT |
no | Se aplica automáticamente a todos los mensajes draft creados con la API de Gmail o la interfaz de Gmail. |
CATEGORY_PERSONAL |
sí | Corresponde a los mensajes que se muestran en la pestaña Personal de la interfaz de Gmail. |
CATEGORY_SOCIAL |
sí | Corresponde a los mensajes que se muestran en la pestaña Social de la interfaz de Gmail. |
CATEGORY_PROMOTIONS |
sí | Corresponde a los mensajes que se muestran en la pestaña Promociones de la interfaz de Gmail. |
CATEGORY_UPDATES |
sí | Corresponde a los mensajes que se muestran en la pestaña Actualizaciones de la interfaz de Gmail. |
CATEGORY_FORUMS |
sí | Corresponde a los mensajes que se muestran en la pestaña Foros de la interfaz de Gmail. |
Administra etiquetas en mensajes y conversaciones
Las etiquetas solo existen en los mensajes. Por ejemplo, si enumeras etiquetas en una conversación, obtienes una lista de las etiquetas que existen en cualquiera de los mensajes de la conversación. Es posible que no haya una etiqueta en cada mensaje de un hilo. Puedes aplicar varias etiquetas a los mensajes, pero no puedes aplicarlas a los mensajes en borrador.
Cómo agregar o quitar etiquetas a conversaciones
Cuando agregas o quitas una etiqueta a una conversación, la agregas o quitas de todos los mensajes existentes en ella.
Si se agregan mensajes a una conversación después de agregar una etiqueta, los mensajes nuevos no heredan la etiqueta existente asociada con la conversación. Para agregar la etiqueta a esos mensajes, vuelve a agregarla a la conversación.
Para agregar o quitar las etiquetas asociadas con un subproceso, usa threads.modify.
Cómo agregar o quitar etiquetas a los mensajes
Cuando agregas una etiqueta a un mensaje, esta se agrega a ese mensaje y se asocia con la conversación a la que pertenece. La etiqueta no se agrega a otros mensajes del subproceso.
Si quitas una etiqueta de un mensaje y este era el único mensaje de la conversación con esa etiqueta, la etiqueta también se quitará de la conversación.
Para agregar o quitar las etiquetas aplicadas a un mensaje, usa messages.modify.