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 los subprocesos: puedes aplicar varias etiquetas a un solo mensaje o subproceso, y una sola etiqueta a varios de ellos.
Para obtener información sobre cómo crear, obtener, list, actualizar o borrar etiquetas, consulta la Referencia de etiquetas.
Para administrar las etiquetas, debes usar el permiso https://www.googleapis.com/auth/gmail.labels
. Para obtener más información sobre los permisos, consulta la información de autorización y autenticación específica de la API de Gmail.
Tipos de etiquetas
Existen dos variedades de etiquetas: etiquetas SYSTEM
reservadas y etiquetas USER
personalizadas.
Las etiquetas del sistema generalmente corresponden a elementos predefinidos en la interfaz web de Gmail, como la carpeta Recibidos. Los nombres de etiquetas de los sistemas están reservados. No se puede crear ninguna etiqueta USER
con el mismo nombre que cualquier etiqueta SYSTEM
. En la siguiente tabla, se enumeran varias de las etiquetas más comunes del sistema de Gmail:
Nombre | Se puede aplicar manualmente | 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 , que se insertan
con messages.insert
y el correo electrónico del usuario en el encabezado From , o que este envía a través
de la interfaz web. |
DRAFT |
no | Se aplica de forma automática 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. |
Cómo administrar etiquetas en mensajes y conversaciones
Solo existen etiquetas en los mensajes. Por ejemplo, si enumeras etiquetas en una conversación, obtendrás una lista de etiquetas que existan en cualquiera de los mensajes de esa conversación. Puede que no exista una etiqueta en todos los mensajes de un subproceso. Puedes aplicar varias etiquetas a los mensajes, pero no a los borradores.
Cómo agregar o quitar etiquetas en conversaciones
Cuando agregas o quitas una etiqueta a una conversación, agregas o quitas la etiqueta especificada en todos los mensajes existentes de esa conversación.
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 en los mensajes
Cuando agregas una etiqueta a un mensaje, la etiqueta se agrega a ese mensaje y se asocia con la conversación a la que pertenece el mensaje. La etiqueta no se agrega a otros mensajes de la conversación.
Si quitas una etiqueta de un mensaje y era el único mensaje de la conversación con esa etiqueta, la etiqueta también se quita de la conversación.
Para agregar o quitar las etiquetas que se aplicaron a un mensaje, usa messages.modify
.