更新邮件

更新 message 对象的属性。

先决条件

要执行此 API,需要以下范围之一:Mail.ReadWrite

HTTP 请求

PATCH /me/messages/{id}
PATCH /users/{id | userPrincipalName}/messages/{id}
PATCH /me/mailFolders/{id}/messages/{id}
PATCH /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}

请求标头

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

请求正文

在请求正文中,提供应更新的相关字段的值。请求正文中不包括的现有属性将保留其以前的值,或根据对其他属性值的更改重新计算。为了获得最佳性能,不应包括尚未更改的现有值。可写/可更新属性

属性 类型 说明
bccRecipients Recipient 邮件的密件抄送收件人。仅当 IsDraft = true 时可以更新。
categories String collection 与邮件关联的类别。
ccRecipients 收件人集合 邮件的抄送收件人。仅当 IsDraft = true 时可以更新。
from Recipient 邮箱所有者和邮件发件人。仅当 IsDraft = true 时可以更新。
importance String 邮件的重要性。可能的值是:LowNormalHigh
inferenceClassification String 根据推导出的相关性或重要性或显式替代,对用户邮件的分类。可能的值是:focusedother
internetMessageId String RFC2822 指定格式的邮件 ID。仅当 IsDraft = true 时可以更新。
isRead Boolean 指示是否已阅读该邮件。
replyTo Recipient collection 在答复时使用的电子邮件地址。仅当 IsDraft = true 时可以更新。
sender Recipient 实际用于生成邮件的帐户。仅当 IsDraft = true 时可以更新。
toRecipients Recipient collection 邮件的收件人。仅当 IsDraft = true 时可以更新。
正文 ItemBody 邮件的正文。仅当 IsDraft = true 时可以更新。
isDeliveryReceiptRequested Boolean 指示是否需要发送邮件已读回执。
isReadReceiptRequested Boolean 指示是否需要发送邮件已读回执。
subject String 邮件的主题。仅当 IsDraft = true 时可以更新。

由于邮件资源支持扩展,因此可以使用 PATCH 操作在现有邮件实例的扩展自定义属性中添加、更新或删除自己的特定于应用的数据。

响应

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

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/v1.0/me/messages/{id}
Content-type: application/json
Content-length: 248

{
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "inferenceClassification": "other"
}
响应

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

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

{
  "receivedDateTime": "datetime-value",
  "sentDateTime": "datetime-value",
  "hasAttachments": true,
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "bodyPreview": "bodyPreview-value",
  "inferenceClassification": "other"
}

另请参阅