Вы можете использовать метки для маркировки, организации и категоризации сообщений и цепочек в Gmail. Ярлык имеет отношение «многие ко многим» к сообщениям и цепочкам: вы можете применить несколько меток к одному сообщению или цепочке, а одну метку — к нескольким сообщениям или цепочкам.
Информацию о том, как создавать , получать , перечислять , обновлять и удалять метки, см. в справочнике по меткам .
Для управления метками необходимо использовать область действия https://www.googleapis.com/auth/gmail.labels . Подробнее об областях действия см. в разделе «Информация об авторизации и аутентификации, специфичная для API Gmail» .
Типы этикеток
Метки бывают двух видов: зарезервированные SYSTEM метки (SYSTEM) и настраиваемые пользовательские метки USER . Системные метки обычно соответствуют предопределённым элементам веб-интерфейса Gmail, например, папке «Входящие». Имена системных меток зарезервированы; невозможно создать USER метку с именем, совпадающим с именем SYSTEM метки. В следующей таблице перечислены некоторые из наиболее распространённых системных меток Gmail:
| Имя | Можно наносить вручную. | Примечания |
|---|---|---|
INBOX | да | |
SPAM | да | |
TRASH | да | |
UNREAD | да | |
STARRED | да | |
IMPORTANT | да | |
SENT | нет | Применяется автоматически к сообщениям, отправленным с помощью drafts.send или messages.send , вставленным с помощью messages.insert и адресом электронной почты пользователя в заголовке From или отправленным пользователем через веб-интерфейс. |
DRAFT | нет | Автоматически применяется ко всем draft сообщений, созданным с помощью API Gmail или интерфейса Gmail. |
CATEGORY_PERSONAL | да | Соответствует сообщениям, отображаемым на вкладке «Личные» интерфейса Gmail. |
CATEGORY_SOCIAL | да | Соответствует сообщениям, отображаемым на вкладке «Социальные сети» интерфейса Gmail. |
CATEGORY_PROMOTIONS | да | Соответствует сообщениям, отображаемым на вкладке «Акции» интерфейса Gmail. |
CATEGORY_UPDATES | да | Соответствует сообщениям, отображаемым на вкладке «Обновления» интерфейса Gmail. |
CATEGORY_FORUMS | да | Соответствует сообщениям, отображаемым на вкладке «Форумы» интерфейса Gmail. |
Управление метками сообщений и обсуждений
Метки существуют только для сообщений. Например, если вы перечислите метки для цепочки, вы получите список меток, которые есть у любого сообщения в этой цепочке. Метка может быть не у каждого сообщения в цепочке. Вы можете применять несколько меток к сообщениям, но не можете применять метки к черновикам сообщений.
Добавлять или удалять метки к темам
При добавлении или удалении метки к цепочке вы добавляете или удаляете указанную метку для всех существующих сообщений в цепочке.
Если сообщения добавляются в цепочку после добавления метки, новые сообщения не наследуют существующую метку, связанную с этой цепочкой. Чтобы добавить метку к этим сообщениям, добавьте её к цепочке повторно.
Чтобы добавить или удалить метки, связанные с потоком, используйте threads.modify .
Добавлять или удалять метки к сообщениям
Когда вы добавляете метку к сообщению, она добавляется к нему и становится связанной с цепочкой сообщений, к которой принадлежит сообщение. Метка не добавляется к другим сообщениям в этой цепочке.
Если вы удалите метку из сообщения, и это было единственное сообщение в цепочке с этой меткой, метка также будет удалена из цепочки.
Чтобы добавить или удалить метки, примененные к сообщению, используйте messages.modify .