大网数据广告活动
Microsoft Graph 接口

outlookCategory 资源类型

· 52CE 我爱测

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

命名空间:microsoft.graph

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

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

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

属性

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

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

方法

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

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 abheek-das)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。