消息:replyAll

命名空间:microsoft.graph

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

使用 JSON 格式时:

  • 指定参数的注释或 正文 属性 message 。 指定这两者将返回 HTTP 400 错误请求错误。
  • 如果原始邮件在 replyTo 属性中指定收件人,则根据 Internet 邮件格式 (RFC 2822) ,请将答复发送给 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 实体正文中的数据性质。 必填。
对 JSON 对象使用 application/json,对 MIME 内容使用 text/plain。
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 格式回复消息的所有内容

下面是一个如何调用此 API 的示例。

请求

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

POST https://graph.microsoft.com/v1.0/me/messages/{id}/replyAll
Content-type: application/json

{
  "comment": "comment-value"
}
响应

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

HTTP/1.1 202 Accepted

示例 2:以 MIME 格式回复邮件的所有内容

请求
POST https://graph.microsoft.com/v1.0/me/messages/AAMkADA1MTAAAAqldOAAA=/replyAll
Content-type: text/plain

Q29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9wa2NzNy1taW1lOw0KCW5hbWU9c21pbWUucDdtOw0KCXNtaW1lLXR5cGU9ZW52ZWxvcGVkLWRhdGENCk1pbWUtVmVyc2lvbjogMS4wIChNYWMgT1MgWCBNYWlsIDEzLjAgXCgzNjAxLjAuMTBcKSkNClN1YmplY3Q6IFJlOiBUZXN0aW5nIFMvTUlNRQ0KQ29udGVudC1EaXNwb3Np
响应

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

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