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