Administrar etiquetas

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
SPAM
TRASH
UNREAD
STARRED
IMPORTANT
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 Corresponde a los mensajes que se muestran en la pestaña Personal de la interfaz de Gmail.
CATEGORY_SOCIAL Corresponde a los mensajes que se muestran en la pestaña Social de la interfaz de Gmail.
CATEGORY_PROMOTIONS Corresponde a los mensajes que se muestran en la pestaña Promociones de la interfaz de Gmail.
CATEGORY_UPDATES Corresponde a los mensajes que se muestran en la pestaña Actualizaciones de la interfaz de Gmail.
CATEGORY_FORUMS 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.