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"
}