outlookCategory 资源类型

命名空间：microsoft.graph

表示用户可以对 Outlook 项目（如邮件和事件）进行分组的类别依据。 用户在主列表中定义类别，并且可以将这些用户定义的一个或多个类别应用到项目中。

使用 REST API，可以在用户类别的主列表中创建和定义类别。 还可以获取主类别列表、获取特定类别、更新与类别相关联的颜色，或删除类别。 可以通过将类别的 displayName 属性分配给项目的 categories 集合，将类别应用到项目。 可分配类别的资源包括 联系人、 事件、 消息、 帖子和 todoTask。

每个类别都有 2 个属性：displayName 和 color。 displayName 值在用户的主列表中必须是唯一的。 然而，color 不一定是唯一的；主列表中的多个类别可以映射到相同颜色。 可以在用户的主列表中将多达 25 种不同的颜色映射到类别。

方法

方法	返回类型	说明
List categories	outlookCategory 集合	获取为用户定义的所有类别。
Get category	outlookCategory	获取指定的 outlookCategory 对象的属性和关系。
Create	outlookCategory	在用户主类别列表中创建 outlookCategory 对象。
Update	outlookCategory	更新指定 outlookCategory 对象的可写属性 color。
删除	无	删除指定的 outlookCategory 对象。

属性

属性	类型	说明
color	categoryColor	预先设定的颜色常数，它表示类别的特征，并映射到 25 种预定义颜色中的一种。 有关详细信息，请参阅以下说明。
displayName	String	标识用户邮箱中的类别的唯一名称。 在创建类别后，名称将无法更改。 只读。

注意：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"
}