Тип ресурса outlookCategory

Пространство имен: microsoft.graph

Представляет категорию, по которой пользователь может группировать такие элементы Outlook, как сообщения и события. Пользователь определяет категории в основном списке и может применить одну или несколько из них к элементу.

С помощью REST API вы можете создавать и определять категории в основном списке категорий для пользователя. Вы также можете получить этот основной список категорий, получить определенную категорию, изменить цвет, связанный с категорией, или удалить категорию. Вы можете применить категорию к списку, добавив значение свойства displayName категории в коллекцию categories элемента. Ресурсы, которым можно назначить категории, включают contact, event, message, post и todoTask.

Каждой категории назначается 2 свойства: displayName и color. Значение displayName должно быть уникальным в основном списке пользователя. Однако значение свойства color может не быть уникальным. Несколько категорий в основном списке можно сопоставить с одним цветом. Вы можете сопоставить до 25 различных цветов с категориями в основном списке пользователя.

Методы

Свойства

Примечание. Допустимые значения свойства color — предустановленные константы, например None, preset0 и preset1. Каждая предустановленная константа сопоставлена с цветом. Фактический цвет зависит от клиента Outlook, в котором отображаются категории. В приведенной ниже таблице показаны цвета, сопоставленные с каждой предустановленной константой для классического клиента Outlook.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "color": "String",
  "displayName": "String"
}