Тип ресурса outlookCategory

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

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

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

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

Методы

Метод	Возвращаемый тип	Описание
Перечисление категорий	Коллекция outlookCategory	Получение всех категорий, определенных для пользователя.
Получение категории	outlookCategory	Получение свойств и отношений указанного объекта outlookCategory.
Создание	outlookCategory	Создание объекта outlookCategory в основном списке категорий пользователя.
Обновление	outlookCategory	Обновление перезаписываемого свойства color указанного объекта outlookCategory.
Удаление	Нет	Удаление указанного объекта outlookCategory.

Свойства

Свойство	Тип	Описание
color	categoryColor	Предустановленная константа, которая характеризует категорию и сопоставлена с одним из 25 предопределенных цветов. Дополнительные сведения см. в следующем примечании.
displayName	Строка	Уникальное имя, обозначающее категорию в почтовом ящике пользователя. После создания категории изменить имя невозможно. Только для чтения.

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

Предустановленная константа	Соответствующий цвет в Outlook
None	Цвет не задан
Preset0	Красный
Preset1	Оранжевый
Preset2	Коричневый
Preset3	Желтый
Preset4	Зеленый
Preset5	Сине-зеленый
Preset6	Оливковый
Preset7	Синий
Preset8	Сиреневый
Preset9	Клюквенный
Preset10	Стальной
Preset11	Темно-стальной
Preset12	Серый
Preset13	Темно-серый
Preset14	Черный
Preset15	Темно-красный
Preset16	Темно-оранжевый
Preset17	Темно-коричневый
Preset18	Темно-желтый
Preset19	Темно-зеленый
Preset20	Темно-бирюзовый
Preset21	Темно-оливковый
Preset22	Темно-синий
Preset23	Темно-фиолетовый
Preset24	Темно-клюквенный

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

Ниже указано представление ресурса в формате JSON.

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