Тип ресурса outlookCategory

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Предостережение

Существующие приложения, использующие эту функцию с задачами Outlook, следует обновить, так как задачи Outlook устарели. Дополнительные сведения см. в статье Api To Do в общедоступной предварительной версии .

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

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

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

Методы

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

Свойства

Свойство	Тип	Описание
color	String	Предустановленная константа, которая характеризует категорию и сопоставлена с одним из 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"
}