Recurso: Etiqueta
Las etiquetas se usan para categorizar los mensajes y las conversaciones dentro del buzón del usuario. La cantidad máxima de etiquetas admitidas para el buzón de un usuario es de 10,000.
Representación JSON |
---|
{ "id": string, "name": string, "messageListVisibility": enum ( |
Campos | |
---|---|
id |
El ID inmutable de la etiqueta. |
name |
El nombre visible de la etiqueta. |
messageListVisibility |
La visibilidad de los mensajes con esta etiqueta en la lista de mensajes de la interfaz web de Gmail. |
labelListVisibility |
La visibilidad de la etiqueta en la lista de etiquetas de la interfaz web de Gmail. |
type |
El tipo de propietario de la etiqueta. El usuario crea las etiquetas de usuario, que pueden modificar y borrar, además de aplicarse a cualquier mensaje o conversación. Las etiquetas del sistema se crean internamente y no se pueden agregar, modificar ni borrar. En determinadas circunstancias, es posible que se puedan aplicar o quitar las etiquetas del sistema en los mensajes y las conversaciones, pero esto no está garantizado. Por ejemplo, los usuarios pueden aplicar y quitar las etiquetas |
messagesTotal |
La cantidad total de mensajes con la etiqueta. |
messagesUnread |
El número de mensajes no leídos con la etiqueta. |
threadsTotal |
La cantidad total de subprocesos con la etiqueta. |
threadsUnread |
El número de conversaciones no leídas con la etiqueta. |
color |
Es el color que se asignará a la etiqueta. El color solo está disponible para las etiquetas que tienen su |
MessageListVisibility
Enumeradores | |
---|---|
show |
Mostrar la etiqueta en la lista de mensajes |
hide |
No mostrar la etiqueta en la lista de mensajes |
LabelListVisibility
Enumeradores | |
---|---|
labelShow |
Mostrar la etiqueta en la lista de etiquetas |
labelShowIfUnread |
Mostrar la etiqueta si hay algún mensaje no leído con esa etiqueta |
labelHide |
No mostrar la etiqueta en la lista de etiquetas |
Tipo
Enumeradores | |
---|---|
system |
Etiquetas creadas por Gmail |
user |
Etiquetas personalizadas creadas por el usuario o la aplicación. |
Color
Representación JSON |
---|
{ "textColor": string, "backgroundColor": string } |
Campos | |
---|---|
textColor |
El color del texto de la etiqueta, representado como cadena hexadecimal. Este campo es obligatorio para establecer el color de una etiqueta. . |
backgroundColor |
El color de fondo representado como una cadena hexadecimal #RRGGBB (p. ej., #000000). Este campo es obligatorio para establecer el color de una etiqueta. . |
Métodos |
|
---|---|
|
Crea una etiqueta nueva. |
|
Borra de manera inmediata y permanente la etiqueta especificada y la quita de todos los mensajes y conversaciones a los que se aplica. |
|
Obtiene la etiqueta especificada. |
|
Enumera todas las etiquetas en el buzón del usuario. |
|
Aplica un parche a la etiqueta especificada. |
|
Actualiza la etiqueta especificada. |