Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: 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"
}