消息:replyAll

命名空间:microsoft.graph

重要

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

使用 JSON 或 MIME 格式回复 邮件 的所有收件人。

使用 JSON 格式时:

  • 指定参数的message注释或 body 属性。 同时指定两者将返回 HTTP 400 无效请求错误。
  • 如果原始邮件在 replyTo 属性中指定了收件人,则根据 RFC 2822) (Internet 消息格式,将答复发送给 replyTo 中的收件人,而不是 from 属性中的收件人。

使用 MIME 格式时:

  • 提供适用的 Internet 邮件头 和 MIME 内容,所有内容在请求正文中都通过 base64 格式进行编码。
  • 向 MIME 内容添加任何附件和 S/MIME 属性。

此方法将邮件保存在“已发送邮件”文件夹中。

或者, 创建一个草稿以全部回复邮件,稍后 发送 。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ✅

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) Mail.Send 不可用。
委派(个人 Microsoft 帐户) Mail.Send 不可用。
应用程序 Mail.Send 不可用。

HTTP 请求

POST /me/messages/{id}/replyAll
POST /users/{id | userPrincipalName}/messages/{id}/replyAll
POST /me/mailFolders/{id}/messages/{id}/replyAll
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/replyAll

请求标头

名称 类型 说明
Authorization string 持有者 {token}。 必需
Content-Type string 实体正文中的数据性质。 必需
用于 application/json JSON 对象和 text/plain MIME 内容
Prefer: outlook.timezone string 为该 API 基于请求正文创建的 HTML 回复消息字段设置 Sent 时区。 该值可以是为用户配置的任何 supportedTimeZones 。 如果未指定,则该 Sent 字段以 UTC 为准。

仅当指定 Content-Type: application/json 标头以 HTML 格式创建答复消息时,才使用此标头。 如果使用 Content-Type: text/plain 标头,则此 Prefer 标头将不起作用。 可选。

请求正文

使用 JSON 格式时,提供具有以下参数的 JSON 对象。

参数 类型 说明
注释 String 要包含的注释。 可以为空字符串。
消息 邮件 要在回复消息中更新的任何可写入属性。

以 MIME 格式指定正文时,请为 MIME 内容提供适用的 Internet 消息标头,所有邮件标头均在请求正文中以 base64 格式编码。 此方法将原始邮件的发件人和所有收件人加载为新邮件的收件人。

响应

如果成功,此方法返回 202 Accepted 响应代码。 它不会返回响应正文中的任何内容。

如果请求正文包含错误的 MIME 内容,此方法将返回 400 Bad request 和以下错误消息:“无效的 base64 字符串 MIME 内容”。

示例

示例 1:以 JSON 格式回复邮件

下面的示例包括一条注释,并将一个附件添加到“全部回复”邮件。

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAH5JaKAAA=/replyAll
Content-Type: application/json

{
    "message":{
      "attachments": [
        {
          "@odata.type": "#microsoft.graph.fileAttachment",
          "name": "guidelines.txt",
          "contentBytes": "bWFjIGFuZCBjaGVlc2UgdG9kYXk="
        }
      ]
    },
    "comment": "Please take a look at the attached guidelines before you decide on the name."
}
响应

以下示例显示了相应的响应。

HTTP/1.1 202 Accepted

示例 2:以 MIME 格式回复邮件

请求
POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAH5JaLAAA=/replyAll
Content-Type: text/plain

RnJvbTogQWxleCBXaWxiZXIgPEFsZXhXQGNvbnRvc28uY29tPgpUbzogTWVnYW4gQm93ZW4gPE1l
Z2FuQkBjb250b3NvLmNvbT4KU3ViamVjdDogSW50ZXJuYWwgUmVzdW1lIFN1Ym1pc3Npb246IFNh
bGVzIEFzc29jaWF0ZQpUaHJlYWQtVG9waWM...

响应

以下示例显示了相应的响应。

HTTP/1.1 202 Accepted

如果请求正文包含错误的 MIME 内容,此方法返回以下错误消息。

HTTP/1.1 400 Bad Request
Content-type: application/json

{
    "error": {
        "code": "ErrorMimeContentInvalidBase64String",
        "message": "Invalid base64 string for MIME content."
    }
}