outlookCategory 资源类型

命名空间:microsoft.graph

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

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

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

方法

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

属性

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

注意color 的可能值为预设的常数,如 Nonepreset0preset1。 每个预设定的常数会被进一步映射到一种颜色;实际颜色取决于显示类别的 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"
}