更新 inferenceclassificationoverride

按指定内容更改替代的 ClassifyAs 字段。

不能在 inferenceClassificationOverride 示例中使用 PATCH 更改任何其他字段。

如果发件人的替代存在,并且发件人更改了他/她的显示名称,可以使用 POST 强制更新现有替代中的名称字段。

如果发件人的替代存在,并且发件人更改了他/她的 SMTP 地址,“更新”此发件人的替代的唯一方法是:删除 现有替代,然后使用新的 SMTP 地址 创建 新替代。

权限

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) Mail.ReadWrite
委派(个人 Microsoft 帐户) Mail.ReadWrite
应用程序 Mail.ReadWrite

HTTP 请求

PATCH /me/inferenceClassification/overrides/{id}
PATCH /users/{id}/inferenceClassification/overrides/{id}

请求标头

名称 类型 说明
Authorization string Bearer {token}。必需。
Content-Type string 实体正文中的数据性质。必需。

请求正文

在请求正文中,提供 classifyAs 的新值。为了获得最佳性能,不应包括尚未更改的现有值。

属性 类型 说明
classifyAs string 指定来自特定发件人的传入邮件始终应如何分类。可能的值是:focusedother

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和更新的 inferenceClassificationOverride 对象。

示例

请求

以下示例将 SMTP 地址 randiw@adatum.onmicrosoft.com 的替代从 other 更改为 focused

PATCH https://graph.microsoft.com/v1.0/me/inferenceClassification/overrides/{id}
Content-type: application/json

{
  "classifyAs": "focused"
}
响应

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

HTTP/1.1 200 OK
Content-type: application/json

{
  "classifyAs": "focused",
  "senderEmailAddress": {
    "name": "Randi Welch",
    "address": "randiw@adatum.onmicrosoft.com"
  },
  "id": "98f5bdef-576a-404d-a2ea-07a3cf34af4r"
}