Поделиться через


Тип ресурса outlookCategory

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

Важно!

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

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

Задачи Outlook устарели и не возвращают данные 10 августа 2022 г. Обновите существующие приложения, использующие эту функцию, с задачами Outlook.

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

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

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

Методы

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

Свойства

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

Заметка Возможные значения цвета — это предустановленные константы, такие как 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"
}