messageRule 资源类型

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

表示应用于用户收件箱中的邮件的规则。

在 Outlook 中,可以为收件箱中的传入邮件设置规则,以便在特定条件下执行具体操作。

可以按编程方式通过收件箱文件夹messageRules 导航属性来访问规则。 每个规则都由此 messageRule 资源表示,可用的规则操作由 messageRuleActions 复杂类型表示,而可用的规则条件和例外则通过 messageRulePredicates 复杂类型表示。

方法

方法 返回类型 说明
List rules messageRule 集合 获取为用户收件箱定义的所有 messageRule 对象。
Get rule messageRule 读取 messageRule 对象的属性和关系。
创建规则 messageRule 通过指定一组条件和操作来创建 messageRule 对象。
更新规则 messageRule messageRule 对象更改可写属性并保存更改。
删除规则 删除指定的 messageRule 对象。

属性

属性 类型 说明
actions messageRuleActions 满足相应条件时对邮件执行的操作。
conditions messageRulePredicates 满足时触发该规则的相应操作的条件。
displayName String 规则的显示名称。
exceptions messageRulePredicates 规则的例外情况。
hasError Boolean 指示规则是否处于错误状态。 只读。
id String 规则的唯一标识符。 只读。
isEnabled Boolean 指示是否启用规则以应用到邮件。
isReadOnly Boolean 表示规则是否为只读且无法由规则 REST API 修改或删除。
Sequence Int32 表示在其他规则中执行规则的顺序。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "actions": {"@odata.type": "microsoft.graph.messageRuleActions"},
  "conditions": {"@odata.type": "microsoft.graph.messageRulePredicates"},
  "displayName": "String",
  "exceptions": {"@odata.type": "microsoft.graph.messageRulePredicates"},
  "hasError": "Boolean",
  "id": "String",
  "isEnabled": "Boolean",
  "isReadOnly": "Boolean",
  "sequence": "Int32"
}