REST Resource: users.labels

Ресурс: Этикетка

Метки используются для категоризации сообщений и цепочек в почтовом ящике пользователя. Максимальное количество меток, поддерживаемое для почтового ящика пользователя, — 10 000.

JSON-представление
{
  "id": string,
  "name": string,
  "messageListVisibility": enum (MessageListVisibility),
  "labelListVisibility": enum (LabelListVisibility),
  "type": enum (Type),
  "messagesTotal": integer,
  "messagesUnread": integer,
  "threadsTotal": integer,
  "threadsUnread": integer,
  "color": {
    object (Color)
  }
}
Поля
id

string

Неизменяемый идентификатор метки.

name

string

Отображаемое имя метки.

messageListVisibility

enum ( MessageListVisibility )

Видимость сообщений с этим ярлыком в списке сообщений веб-интерфейса Gmail.

labelListVisibility

enum ( LabelListVisibility )

Видимость ярлыка в списке ярлыков веб-интерфейса Gmail.

type

enum ( Type )

Тип владельца метки. Ярлыки пользователя создаются пользователем и могут быть изменены и удалены пользователем, а также применены к любому сообщению или цепочке. Системные метки создаются внутри компании и не могут быть добавлены, изменены или удалены. При некоторых обстоятельствах системные метки можно применять к сообщениям и цепочкам или удалять из них, но это не гарантируется. Например, пользователи могут применять и удалять метки INBOX » и UNREAD из сообщений и цепочек, но не могут применять или удалять метки DRAFTS » или SENT » из сообщений или цепочек.

messagesTotal

integer

Общее количество сообщений с меткой.

messagesUnread

integer

Количество непрочитанных сообщений с меткой.

threadsTotal

integer

Общее количество потоков с меткой.

threadsUnread

integer

Количество непрочитанных тем с меткой.

color

object ( Color )

Цвет, который необходимо назначить метке. Цвет доступен только для меток, type которых установлен на user .

Список сообщенийВидимость

Перечисления
show Показывать метку в списке сообщений.
hide Не показывать метку в списке сообщений.

LabelListVisibility

Перечисления
labelShow Показать метку в списке меток.
labelShowIfUnread Показывать метку, если есть непрочитанные сообщения с этой меткой.
labelHide Не показывать метку в списке меток.

Тип

Перечисления
system Ярлыки, созданные Gmail.
user Пользовательские метки, созданные пользователем или приложением.

Цвет

JSON-представление
{
  "textColor": string,
  "backgroundColor": string
}
Поля
textColor

string

Цвет текста метки, представленный в виде шестнадцатеричной строки. Это поле необходимо для установки цвета метки. Разрешены только следующие предопределенные наборы значений цвета:
#000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, #fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be , #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, # ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #c ф8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c #464646, #e7e7 е7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, # fdedc1 , #0b4f30, #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, # 42д692, #16а765

backgroundColor

string

Цвет фона представлен в виде шестнадцатеричной строки #RRGGBB (например, #000000). Это поле необходимо для установки цвета метки. Разрешены только следующие предопределенные наборы значений цвета:
#000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, #fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be , #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, # ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #c ф8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c #464646, #e7e7 е7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, # fdedc1 , #0b4f30, #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, # 42д692, #16а765

Методы

create

Создает новую метку.

delete

Немедленно и навсегда удаляет указанную метку и удаляет ее из всех сообщений и цепочек, к которым она применена.

get

Получает указанную метку.

list

Перечисляет все метки в почтовом ящике пользователя.

patch

Исправьте указанную метку.

update

Обновляет указанную метку.