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