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

В этом документе объясняется, как управлять метками в цепочках сообщений и самих сообщениях с помощью API Gmail.

В Gmail вы можете использовать метки для маркировки, организации и классификации сообщений и цепочек сообщений. Метка имеет отношение «многие ко многим» к сообщениям и цепочкам сообщений: вы можете применить несколько меток к одному сообщению или цепочке сообщений, и одну метку — к нескольким сообщениям или цепочкам сообщений.

Для получения информации о том, как создавать , получать , отображать , обновлять или удалять метки, см. раздел labels .

Для управления метками необходимо использовать неконфиденциальную область действия https://www.googleapis.com/auth/gmail.labels . Дополнительную информацию об областях действия см. в разделе «Выбор областей действия API Gmail» .

Типы этикеток

Метки бывают двух типов: зарезервированные метки SYSTEM и пользовательские метки USER .

Системные метки обычно соответствуют предопределенным элементам в веб-интерфейсе Gmail, таким как INBOX . Названия системных меток зарезервированы; нельзя создать метку 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 .