Управление ярлыками

Вы можете использовать метки для пометки, систематизации и классификации сообщений и цепочек в 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 .