创建邮件

使用此 API 创建新邮件的草稿。可以在任意文件夹中创建草稿,也可以在发送前更新草稿。若要将邮件保存到“草稿”文件夹,请使用 /messages 快捷方式。

在同一个 POST 调用中创建草稿时,可以添加附件

先决条件

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

HTTP 请求

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

请求标头

标头
Authorization Bearer . Required.
Content-Type application/json

请求正文

在请求正文中,提供 Message 对象的 JSON 表示形式。

由于邮件资源支持扩展因此可以使用 POST 操作,并在创建邮件时向其添加含有自己的数据的自定义属性。

响应

如果成功,此方法在响应正文中返回 201, Created 响应代码和 message 对象。

示例

请求 1

下面是一个请求示例。

POST https://graph.microsoft.com/v1.0/me/messages
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"
}

在请求正文中,提供 Message 对象的 JSON 表示形式。

响应 1

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

HTTP/1.1 201 Created
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"
}

另请参阅