Outlook 邮件 REST API 的参考（版本 1.0）

项目
06/30/2018

备注

Outlook REST API 的版本 1.0 正被弃用。自 2018 年 11 月 1 日 开始，应用将无法再在 1.0 版 REST 端点上使用基本身份验证。截止到 2019 年 11 月 1 日，1.0 版 REST 端点将完全停用，并且 1.0 版文档将在不久之后移除。请开始迁移你的应用，以便在 Microsoft Graph 1.0 版中使用 Outlook REST API。更多详情，请参阅我们的通知。

Outlook 邮件 API 允许你阅读、创建和发送消息和附件，查看和响应事件消息，并管理由 Office 365 中的 Azure Active Directory 保护的文件夹。它还提供相同的功能给特定于以下域中的 Microsoft 帐户：Hotmail.com、Live.com、MSN.com、Outlook.com 和 Passport.com。

备注

为简便起见，本文的其余部分使用 Outlook.com 来指代这些 Microsoft 帐户域。

对 API 的 1.0 版不感兴趣？ 在左侧的目录中，转到 Office 365 REST API 参考部分，然后选择所需的版本。

所有“邮件 API”操作

消息操作

消息存储在邮箱文件夹中，因此消息端点通常包含该消息所在的文件夹。文件夹由 ID 或以下其中一个知名文件夹名指定： Inbox， Drafts， SentItems，或者 DeletedItems。

获取消息
同步消息
创建并发送消息
回复或全部回复消息
转发新的消息或起草消息
更新消息
删除消息
移动或复制消息
管理重点收件箱
管理 @ 提及（预览）
管理规则（预览）
取消订阅（预览）
获取语言选项（预览）
获取时区选项（预览）
获取邮箱设置
获取自动回复设置
更新自动回复设置
获取邮件提示（预览）
获取附件
创建附件
删除附件

文件夹操作

邮箱文件夹可以包含消息和其他文件夹。你可以获取、创建、改变、删除和管理文件夹。你可以使用以下知名文件夹名而不是 ID 来指定相应的文件夹： Inbox、 SentItems、 Drafts、或者 DeletedItems。

获取文件夹
同步文件夹
创建文件夹
更新文件夹
删除文件夹
移动或复制文件夹

另请参阅

使用“邮件 REST API”

身份验证

像其他 Outlook REST API 那样，对于邮件 API 的每个请求，都应该包含有效的访问令牌。获取访问令牌需要注册和识别应用，并获得相应的授权。

你可以了解更多有关简化注册和授权选项的信息。在邮件 API 中继续执行特定操作时，请记住这一点。

API 版本

Outlook REST API 的所有版本都支持“邮件 REST API”。功能可能因具体版本而异。

目标用户

除非指定，否则所有“邮件 API”请求均代表登录用户执行。如果有适当的权限，可以在登录用户或用户 ID 指定的用户上执行如“重点收件箱 API”之类的一些 API 子集。

有关 Outlook REST API 所有子集所共有的更多信息，请参阅使用 Outlook REST API。

获取消息

你可以从邮箱文件夹中获取消息集合或单条消息。

响应中的每条消息都包含多个属性，包括正文属性。消息正文可以是文本或 HTML。如果正文是 HTML 格式，默认情况下，在 REST 响应中返回正文内容之前，将删除嵌入 Body 属性中的任意具有潜在不安全的 HTML（例如，JavaScript）。

要获取整个原始 HTML 内容，请包含以下 HTTP 请求标头：

Prefer: outlook.allow-unsafe-html

目前，此 GET 操作返回纯 HTML 格式的消息正文。

获取消息集合
获取一封消息

获取消息集合

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.read
wl.imap

备注

本节中的操作行为因版本而异。选择左侧的目录中 Office 365 REST API 参考下的版本以了解更多详情。

从收件箱中获取消息集合。

GET https://outlook.office.com/api/v1.0/me/messages

你还可以在用户的邮箱中指定一个文件夹并从该文件夹中获取消息集合。

GET https://outlook.office.com/api/v1.0/me/MailFolders/{folder_id}/messages

必需的参数	类型	说明
URL 参数
folder_id	字符串	文件夹 ID 或 `Inbox`、 `Drafts`、 `SentItems` 或者 `DeletedItems` 已知文件夹名（如果你正在从特定文件夹中收到消息）。

备注

默认情况下，响应中的每封消息都包含其所有属性。使用 $select 仅指定那些你需要的属性，从而实现最佳性能。始终返回 Id 属性。请参阅 OData 查询参数，了解筛选、排序和分页参数。

以下示例显示如何使用 $select 指定在响应中仅返回每封消息的发件人和主题属性。请参阅获取消息中的示例响应，以了解当您不使用 $select 时为一个消息返回的完整属性列表。

示例请求

GET https://outlook.office.com/api/v1.0/me/folders/sentitems/messages/?$select=Sender,Subject

示例响应

状态代码：200

{
    "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders('sentitems')/Messages(Sender,Subject)",
    "value": [
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Messages('AAMkAGI2TIy-AAA=')",
            "@odata.etag": "W/\"CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqS\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTIzAAAA=",
            "Subject": "Meeting Notes",
            "Sender": {
                "EmailAddress": {
                    "Name": "Alex D",
                    "Address": "/O=EXCHANGELABS/OU=EXCHANGE ADMINISTRATIVE GROUP (FYDIBOHF23SPDLT)/CN=RECIPIENTS/CN=1A5F1737122542AEA595DF9590A1C6FD-ALEXD"
                }
            }
        },
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Messages('AAMkAGI2TIy-AAA=')",
            "@odata.etag": "W/\"CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqP\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTIy-AAA=",
            "Subject": "Contract Signing",
            "Sender": {
                "EmailAddress": {
                    "Name": "Alex D",
                    "Address": "/O=EXCHANGELABS/OU=EXCHANGE ADMINISTRATIVE GROUP (FYDIBOHF23SPDLT)/CN=RECIPIENTS/CN=1A5F1737122542AEA595DF9590A1C6FD-ALEXD"
                }
            }
        },
        {
            "@odata.type": "#Microsoft.OutlookServices.EventMessage",
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Messages('AAMkAGI2TIy-AAA=')",
            "@odata.etag": "W/\"CwAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqJ\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTIy9AAA=",
            "Subject": "Rob:Alex 1:1",
            "Sender": {
                "EmailAddress": {
                    "Name": "Alex D",
                    "Address": "/O=EXCHANGELABS/OU=EXCHANGE ADMINISTRATIVE GROUP (FYDIBOHF23SPDLT)/CN=RECIPIENTS/CN=1A5F1737122542AEA595DF9590A1C6FD-ALEXD"
                }
            }
        }
    ]
}

响应类型

请求的消息集合。

获取一封消息

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.read
wl.imap

通过 ID 获取消息。

GET https://outlook.office.com/api/v1.0/me/messages/{message_id}

必需的参数	类型	说明
URL 参数
message_id	字符串	消息 ID。

示例请求

GET https://outlook.office.com/api/v1.0/me/messages/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA=

示例响应

状态代码：200

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIKz\"",
  "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA=",
  "ChangeKey": "CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIKz",
  "Categories": [],
  "DateTimeCreated": "2014-10-20T00:41:57Z",
  "DateTimeLastModified": "2014-10-20T00:41:57Z",
  "Subject": "Re: Meeting Notes",
  "BodyPreview": "________________________________________\nFrom: Alex D\nSent: Sunday, October 19, 2014 5:28 PM\nTo: Katie Jordan\nSubject: Meeting Notes\n\nPlease send me the meeting notes ASAP",
  "Body": {
    "ContentType": "Text",
    "Content": "\n________________________________________\nFrom: Alex D\nSent: Sunday, October 19, 2014 5:28 PM\nTo: Katie Jordan\nSubject: Meeting Notes\n\nPlease send me the meeting notes ASAP\n"
  },
  "Importance": "Normal",
  "HasAttachments": true,
  "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEMAAA=",
  "From": {
    "EmailAddress": {
      "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Katie Jordan"
    }
  },
  "Sender": {
    "EmailAddress": {
      "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Katie Jordan"
    }
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Alex D"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAQAEmjRj3pwjRLrbymGMYyEto=",
  "DateTimeReceived": "2014-10-20T00:41:57Z",
  "DateTimeSent": "2014-10-20T00:41:53Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": false,
  "IsRead": false
}

响应类型

请求的消息。

备注

默认情况下，响应包含指定消息的所有属性。使用 $select 仅指定那些你需要的属性，从而实现最佳性能。始终返回 Id 属性。请参阅 OData 查询参数，了解筛选、排序和分页参数。

以下示例显示如何使用 $select 指定在响应中仅返回每条消息的 发件人 和主题属性。

GET https://outlook.office.com/api/v1.0/me/messages/AAMkAGEI5MTAAA=?$select=Sender,Subject

同步消息

这个功能目前只在 beta 版中可用。要了解详细信息，请在左侧的目录中转到 Office 365 REST API 参考部分，并选择 beta。

创建并发送消息

你可以即时发送新消息，或创建草稿消息，然后发送。你可以在任何文件夹中创建草稿。

即时发送新消息
创建草稿消息
发送草稿消息

即时发送新消息

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.send
wl.imap

通过使用 SendMail 方法发送请求正文中提供的消息。通过在附件集合属性中指定，你可以在同一个操作调用中包含一个或多个附件。你还可以将消息保存在“已发送消息”文件夹中。

POST https://outlook.office.com/api/v1.0/me/sendmail

必需的参数	类型	说明
正文参数
Message	Message	要发送的消息。
SavetoSentItems	布尔值	指示是否将消息保存在“已发送消息”中。默认值为 True。

在请求正文中，使用必需的 ToRecipients 属性和任何可写的消息属性来指定 Message 参数。只有为 false 时才需要 SaveToSentItems 参数。

示例请求

POST https://outlook.office.com/api/v1.0/me/sendmail

{
  "Message": {
    "Subject": "Meet for lunch?",
    "Body": {
      "ContentType": "Text",
      "Content": "The new cafeteria is open."
    },
    "ToRecipients": [
      {
        "EmailAddress": {
          "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com"
        }
      }
    ],
    "Attachments": [
      {
        "@odata.type": "#Microsoft.OutlookServices.FileAttachment",
        "Name": "menu.txt",
        "ContentBytes": "bWFjIGFuZCBjaGVlc2UgdG9kYXk="
      }
    ]
  },
  "SaveToSentItems": "false"
}

示例响应

Status code: 202

创建草稿消息

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

创建新消息的草稿。草稿可以在任何文件夹中创建，也可以选择更新之后发送。要保存到草稿文件夹，请使用 /me/messages 快捷方式。

POST https://outlook.office.com/api/v1.0/me/messages
POST https://outlook.office.com/api/v1.0/me/folders/{folder_id}/messages

必需的参数	类型	说明
URL 参数
folder_id	字符串	目标文件夹 ID，或者 `Inbox` 或 `Drafts` 已知文件夹的名称。

在请求正文中指定任何可写的消息属性。

示例请求

POST https://outlook.office.com/api/v1.0/me/folders/inbox/messages

Content-Type: application/json

{
  "Subject": "Did you see last night's game?",
  "Importance": "Low",
  "Body": {
    "ContentType": "HTML",
    "Content": "They were <b>awesome</b>!"
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com"
      }
    }
  ]
}

示例响应

状态代码：201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0Ag5\"",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MABGAAAAAAC_0WfqSjt_SqLtNkuO-bj1BwAmP1Ln1wcHRariNdTMGAO9AAAAAAEPAAAmP1Ln1wcHRariNdTMGAO9AAASz7k0AAA=",
  "ChangeKey": "CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0Ag5",
  "Categories": [],
  "DateTimeCreated": "2014-10-18T20:06:51Z",
  "DateTimeLastModified": "2014-10-18T20:06:51Z",
  "Subject": "Did you see last night's game?",
  "BodyPreview": "They were awesome!",
  "Body": {
    "ContentType": "HTML",
    "Content": "<html>\r\n<head>\r\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\r\n</head>\r\n<body>\r\nThey were <b>awesome</b>!\r\n</body>\r\n</html>\r\n"
  },
  "Importance": "Low",
  "HasAttachments": false,
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEPAAA=",
  "From": null,
  "Sender": null,
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Katie Jordan"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAQADXiGXoAtX9IubRTpv2hisc=",
  "DateTimeReceived": "2014-10-18T20:06:51Z",
  "DateTimeSent": "2014-10-18T20:06:51Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": true,
  "IsRead": true
}

响应类型

草稿消息。

发送草稿消息

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.send
wl.imap

通过使用发送方法，发送新消息草稿、回复草稿、全部答复草稿或 转发草稿。然后消息保存在“已发送消息”文件夹中。

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/send

必需的参数	类型	说明
URL 参数
message_id	字符串	待发送草稿消息的 ID。

示例请求

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz7k0AAA=/send

示例响应

Status code: 202

回复或全部回复消息

备注

本节中的操作行为因版本而异。选择左侧的目录中 Office 365 REST API 参考下的版本以了解更多详情。

你可以即时回复注释，也可以先创建回复草稿，然后更新并发送草稿。

你只能回复消息的发件人或一次回答所有收件人。

即时回复发件人
即时全部答复
创建回复消息草稿
创建全部回复消息草稿

即时回复发件人

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.send
wl.imap

通过指定注释并使用回复方法来回复消息的发件人。然后消息保存在“已发送消息”文件夹中。

或者，如果你需要修改回复的任何可更新的属性，你可以先创建草稿回复消息，更新消息属性，然后发送回复。

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/reply

必需的参数	类型	说明
URL 参数
message_id	字符串	要回复的消息 ID。
正文参数
Comment	字符串	要包含的注释。可以为空字符串。

示例请求

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8DmAAA=/reply
Content-Type: application/json

{
  "Comment": "Sounds great! See you tomorrow."
}

示例响应

Status code: 202

即时全部答复

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.send
wl.imap

通过指定注释并使用 ReplyAll 方法来回复消息的所有收件人。然后消息保存在“已发送消息”文件夹中。

或者，如果你需要修改回复的任何可更新属性，你可以先创建草稿全部回复消息，更新消息属性，然后发送回复。

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/replyall

必需的参数	类型	说明
URL 参数
message_id	字符串	要回复的消息 ID。
正文参数
Comment	字符串	要包含的注释。可以为空字符串。

示例请求

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0MSz8DmAAA=/replyall
Content-Type: application/json

{
  "Comment": "Thanks for the heads up."
}

示例响应

Status code: 202

创建回复消息草稿

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

创建回复指定消息的草稿。然后你可以更新草稿，将回复内容添加到正文属性，或更改其他消息属性，或者直接发送草稿。

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/createreply

必需的参数	类型	说明
URL 参数
message_id	字符串	要回复的消息 ID。

示例请求

POST https://outlook.office.com/api/v1.0/me/messages/AAMkADA1MTAAAAqldOAAA=/createreply

示例响应

Status code: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('86b6ceaf-57f7-4278-97c4-4da0a97f6cdb@70559e59-b378-49ea-8e53-07a3a3d27f5b')/Messages('AAMkADA1MTAAAH5JKoAAA=')",
  "@odata.etag": "W/\"CQAAABYAAADX8oL1Wa7jQbcPAHouCzswAAAH5/DO\"",
  "Id": "AAMkADA1MTAAAH5JKoAAA=",
  "CreatedDateTime": "2016-03-15T08:33:43Z",
  "LastModifiedDateTime": "2016-03-15T08:33:43Z",
  "ChangeKey": "CQAAABYAAADX8oL1Wa7jQbcPAHouCzswAAAH5/DO",
  "Categories": [ ],
  "ReceivedDateTime": "2016-03-15T08:33:43Z",
  "SentDateTime": "2016-03-15T08:33:43Z",
  "HasAttachments": false,
  "InternetMessageId": "<DM2PR00MB00571796B16132601E1F286CF7890@DM2PR00MB0057.namprd00.prod.outlook.com>",
  "Subject": "RE: Let's start a group",
  "Body": {
    "ContentType": "HTML",
    "Content": "<html>\r\n<body>Fanny, would you name the group if the project is approved, please?\r\n<b>From:</b> Fanny Downs<br>\r\n<b>Sent:</b> Friday, March 4, 2016 12:23:35 AM<br>\r\n<b>To:</b> Admin<br>\r\n<b>Subject:</b> Re: Let's start a group</font>\r\n<p>That's a great idea!<br>\r\n</body>\r\n</html>"
  },
  "BodyPreview": "Fanny, would you name the group if the project is approved, please?\r\n________________________________\r\nFrom: Fanny Downs\r\nSent: Friday, March 4, 2016 12:23:35 AM\r\nTo: Admin\r\nSubject: Re: Let's start a group\r\n\r\n\r\nThat's a gre",
  "Importance": "Normal",
  "ParentFolderId": "AQMkADA1MTAAAAIBDwAAAA==",
  "Sender": {
    "EmailAddress": {
      "Name": "Admin",
      "Address": "admin@contoso.onmicrosoft.com"
    }
  },
  "From": null,
  "ToRecipients": [
    {
      "EmailAddress": {
        "Name": "Fanny Downs",
        "Address": "fannyd@contoso.onmicrosoft.com"
      }
    }
  ],
  "CcRecipients": [ ],
  "BccRecipients": [ ],
  "ReplyTo": [ ],
  "ConversationId": "AAQkADA1MTVGjIwpLvWmGtIo-aFE=",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsRead": true,
  "IsDraft": true,
  "WebLink": "https://outlook.office.com/owa/?ItemID=AAMkADA1MTAAAH5JKoAAA%3D&exvsurl=1&viewmodel=ReadMessageItem",
  "MentionedMe": null,
  "AppliedHashtagsPreview": null,
  "LikesPreview": null,
  "MentionsPreview": null,
  "Mentioned": [ ],
  "InferenceClassification": "Focused",
  "UnsubscribeData": [ ],
  "UnsubscribeEnabled": false,
  "Flag": { "FlagStatus": "NotFlagged" }
}

响应类型

含 ToRecipient、 IsDraft、以及其他预填充适当属性的草稿回复消息。

创建全部回复消息草稿

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

创建草稿以回复指定消息的发件人和所有收件人。然后你可以更新草稿，将回复内容添加到正文，或更改其他消息属性，或者直接发送草稿。

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/createreplyall

必需的参数	类型	说明
URL 参数
message_id	字符串	要回复的消息 ID。

示例请求

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8DmAAA=/createreplyall

示例响应

Status code: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Messages('AAMkAGE0Mz7k5AAA=')",
  "@odata.etag": "W/\"CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AhF\"",
  "Id": "AAMkAGE0Mz7k5AAA=",
  "ChangeKey": "CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AhF",
  "Categories": [],
  "CreatedDateTime": "2014-10-18T21:21:06Z",
  "LastModifiedDateTime": "2014-10-18T21:21:06Z",
  "Subject": "RE: Check out the new Office 365 APIs",
  "BodyPreview": "If the project gets approved, please decide on the name.\r\n_________________________________\r\nFrom: Alex D\r\nSent: Saturday, October 18, 2014 9:18:18 PM\r\nTo: Katie Jordan; Garth Fort\r\nSubj",
  "Body": {
    "ContentType": "HTML",
    "Content": "<html>\r\n...</html>\r\n"
  },
  "Importance": "Normal",
  "HasAttachments": false,
  "ParentFolderId": "AAMkAGE0MAAEPAAA=",
  "From": null,
  "Sender": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Katie Jordan"
      }
    },
    {
      "EmailAddress": {
        "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Garth Fort"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGE0M3HbTkEU=",
  "ReceivedDateTime": "2014-10-18T21:21:06Z",
  "SentDateTime": "2014-10-18T21:21:06Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": true,
  "IsRead": true
}

响应类型

含 ToRecipient、 IsDraft、以及其他预填充的适当属性的草稿回复消息。

转发新的消息或起草消息

备注

本节中的操作行为因版本而异。选择左侧的目录中 Office 365 REST API 参考下的版本以了解更多详情。

你可以直接转发消息，也可以创建转发消息的草稿，然后进行更新并发送。

直接转发草稿
创建转发草稿

直接转发草稿

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.send
wl.imap

通过使用转发方法转发消息，也可以选择性地指定注释。然后消息保存在“已发送消息”文件夹中。

另外，如果你需要在要转发的消息中修改任何可更新的属性，你可以先创建一个转发消息草稿，更新消息属性，然后发送回复。

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/forward

必需的参数	类型	说明
URL 参数
message_id	字符串	要转发的消息 ID。
正文参数
Comment	字符串	要包含的注释。可以为空字符串。
ToRecipients	(收件人) 集合	收件人列表

指定注释和请求正文中的 ToRecipients 参数。

示例请求

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8DmAAA=/forward
Content-Type: application/json

{
  "Comment": "FYI",
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com"
      }
    },
    {
      "EmailAddress": {
        "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com"
      }
    }
  ]
}

示例响应

Status code: 202

创建转发消息的草稿

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

创建草稿以转发指定消息。然后你可以更新草稿以将内容添加到正文或更改其他消息属性，或者直接发送草稿。

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/createforward

必需的参数	类型	说明
URL 参数
message_id	字符串	要转发的消息 ID。

示例请求

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8DmAAA=/createforward

示例响应

Status code: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Messages('AAMkAGE0Mz7k6AAA=')",
  "@odata.etag": "W/\"CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AhG\"",
  "Id": "AAMkAGE0Mz7k6AAA=",
  "ChangeKey": "CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AhG",
  "Categories": [],
  "CreatedDateTime": "2016-03-15T08:42:10Z",
  "LastModifiedDateTime": "2016-03-15T08:42:10Z",
  "Subject": "FW: Let's start a group",
  "BodyPreview": "Dana, just want to make sure you get this.\r\n________________________________\r\nFrom: Admin\r\nSent: Tuesday, March 15, 2016 6:47:54 AM\r\nTo: Fanny Downs; Randi Welch\r\nSubject: RE: Let's st",
  "Body": {
    "ContentType": "HTML",
    "Content": "<html>\r\n...</html>\r\n"
  },
  "Importance": "Normal",
  "HasAttachments": false,
  "ParentFolderId": "AAMkAGE0MAAEPAAA=",
  "From": null,
  "Sender": {
    "EmailAddress": {
      "Address": "'alexd@contoso.onmicrosoft.com'",
      "Name": "Alex D"
    }
  },
  "ToRecipients": [],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGE0M3HbTkEU=",
  "ReceivedDateTime": "2016-03-15T08:42:10Z",
  "SentDateTime": "2016-03-15T08:42:10Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": true,
  "IsRead": true
}

响应类型

含 IsDraft 和预先填充适当的属性的草稿转发消息。

更新消息

更改消息的可写属性并保存更改。

更新消息

更新消息

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

更改草稿或现有消息上的可写属性。只有你指定的属性才会更改。

PATCH https://outlook.office.com/api/v1.0/me/messages/{message_id}

必需的参数	类型	说明
URL 参数
message_id	字符串	要更新的消息的 ID。

在请求正文中指定一个或多个可写消息属性。

示例请求

PATCH https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MABGAAAAAAC_0WfqSjt_SqLtNkuO-bj1BwAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAAmP1Ln1wcHRariNdTMGAO9AAASz8S-AAA=

Content-Type: application/json

{
  "Categories": [
    "Orange category",
    "Green category"
  ],
  "IsRead": true
}

示例响应

状态代码：200

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AIP\"",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MABGAAAAAAC_0WfqSjt_SqLtNkuO-bj1BwAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAAmP1Ln1wcHRariNdTMGAO9AAASz8S-AAA=",
  "ChangeKey": "CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AIP",
  "Categories": [
    "Orange category",
    "Green category"
  ],
  "DateTimeCreated": "2014-10-17T17:12:15Z",
  "DateTimeLastModified": "2014-10-19T03:24:35Z",
  "Subject": "Meeting notes from today",
  "BodyPreview": "See attached",
  "Body": {
    "ContentType": "HTML",
    "Content": "<html>\r\n<head>\r\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\r\n<style type=\"text/css\" style=\"display:none\"><!-- p { margin-top: 0px; margin-bottom: 0px; }--></style>\r\n</head>\r\n<body dir=\"ltr\">\r\n<div id=\"divtagdefaultwrapper\" style=\"color: rgb(0, 0, 0); font-family: Calibri,Arial,Helvetica,sans-serif; font-size: 12pt; background-color: rgb(255, 255, 255);\">\r\n<p>See attached</p>\r\n</div>\r\n</body>\r\n</html>\r\n"
  },
  "Importance": "Normal",
  "HasAttachments": true,
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAA=",
  "From": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "Sender": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Katie Jordan"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAQANKneItHNYxNlwnKip-qvhs=",
  "DateTimeReceived": "2014-10-17T17:12:15Z",
  "DateTimeSent": "2014-10-17T17:12:12Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": false,
  "IsRead": true
}

响应类型

已更新的消息。

删除消息

删除消息

备注

删除消息时请小心。已删除内容可能无法恢复。要了解更多信息，请参阅删除项目。

删除消息

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

DELETE https://outlook.office.com/api/v1.0/me/messages/{message_id}

必需的参数	类型	说明
URL 参数
message_id	字符串	要删除的消息的 ID。

示例请求

DELETE https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8TBAAA=

示例响应

Status code: 204

移动或复制消息

你可以移动或复制消息到文件夹。

移动消息
复制消息

移动消息

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

将消息移到文件夹。此操作会在目标文件夹中新建消息副本。

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/move

必需的参数	类型	说明
URL 参数
message_id	字符串	要移动的消息 ID。
正文参数
DestinationId	字符串	目标文件夹 ID，或者 `Inbox`、`Drafts`、`SentItems` 或 `DeletedItems` 已知文件夹的名称。

示例请求

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTIy-AAA=/move

Content-Type: application/json

{
  "DestinationId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEJAAA="
}

示例响应

状态代码：201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqP\"",
  "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTshBhAAA=",
  "ChangeKey": "CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqP",
  "Categories": [],
  "DateTimeCreated": "2014-10-20T00:13:21Z",
  "DateTimeLastModified": "2014-10-20T00:13:23Z",
  "Subject": "Contract Signing",
  "BodyPreview": "There will be a detailed legal review of Project Falcon once the contract is ready.",
  "Body": {
    "ContentType": "Text",
    "Content": "There will be a detailed legal review of Project Falcon once the contract is ready."
  },
  "Importance": "Normal",
  "HasAttachments": false,
  "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEJAAA=",
  "From": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "Sender": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Katie Jordan"
      }
    },
    {
      "EmailAddress": {
        "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Garth Fort"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAQAKjRc0YJSUBJpofjWgitxag=",
  "DateTimeReceived": "2014-10-20T00:13:21Z",
  "DateTimeSent": "2014-10-20T00:13:21Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": false,
  "IsRead": true
}

响应类型

已移动的消息。

复制消息

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

将消息复制到文件夹。

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/copy

必需的参数	类型	说明
URL 参数
message_id	字符串	要移动的消息 ID。
正文参数
DestinationId	字符串	目标文件夹 ID，或者 `Inbox`、`Drafts`、`SentItems` 或 `DeletedItems` 已知文件夹的名称。

示例请求

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTIy-AAA=/copy

Content-Type: application/json

{
  "DestinationId": "inbox"
}

示例响应

状态代码：201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AIS\"",
  "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADT8DtAAA=",
  "ChangeKey": "CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqP",
  "Categories": [],
  "DateTimeCreated": "2014-10-20T00:13:21Z",
  "DateTimeLastModified": "2014-10-20T00:13:23Z",
  "Subject": "Contract Signing",
  "BodyPreview": "There will be a detailed legal review of Project Falcon once the contract is ready.",
  "Body": {
    "ContentType": "Text",
    "Content": "There will be a detailed legal review of Project Falcon once the contract is ready."
  },
  "Importance": "Normal",
  "HasAttachments": false,
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAA=",
  "From": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "Sender": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Katie Jordan"
      }
    },
    {
      "EmailAddress": {
        "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Garth Fort"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAQAKjRc0YJSUBJpofjWgitxag=",
  "DateTimeReceived": "2014-10-20T00:13:21Z",
  "DateTimeSent": "2014-10-20T00:13:21Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": false,
  "IsRead": true
}

响应类型

该消息的新副本。

管理重点收件箱

这个功能目前在 v2.0 版和测试版可用。要了解详细信息，在左侧的目录转到 Office 365 REST API 引用部分，并选择以下版本之一。

管理 @-Mentions（预览）

这个功能目前在 beta 版中可用。要了解详细信息，请在左侧的目录中转到 Office 365 REST API 参考部分，并选择 beta。

管理规则（预览）

这个功能目前在 beta 版中可用。要了解详细信息，请在左侧的目录中转到 Office 365 REST API 参考部分，并选择 beta。

取消订阅（预览）

这个功能目前在 beta 版中可用。要了解详细信息，请在左侧的目录中转到 Office 365 REST API 参考部分，并选择 beta。

获取语言选项（预览）

此功能目前只在 beta 版中可用。要了解详细信息，请在左侧的目录中转到 Office 365 REST API 参考部分，并选择 beta。

获取时区选项（预览）

此功能目前只在 beta 版中可用。要了解详细信息，请在左侧的目录中转到 Office 365 REST API 参考部分，并选择 beta。

获取邮箱设置

这个功能目前在 v2.0 版和测试版可用。要了解详细信息，在左侧的目录转到 Office 365 REST API 引用部分，并选择以下版本之一。

获取自动回复设置

这个功能目前在 v2.0 版和测试版可用。要了解详细信息，在左侧的目录转到 Office 365 REST API 引用部分，并选择以下版本之一。

更新自动回复设置

这个功能目前在 v2.0 版和测试版可用。要了解详细信息，在左侧的目录转到 Office 365 REST API 引用部分，并选择以下版本之一。

获取 MailTips（预览）

这个功能目前在 beta 版中可用。要了解详细信息，请在左侧的目录中转到 Office 365 REST API 参考部分，并选择 beta。

获取附件

你可以获取附件集合或获取附件。附件可以是文件（例如，

获取附件集合
获取附件

获取附件集合

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.read
wl.imap

获取特定消息的附件。

GET https://outlook.office.com/api/v1.0/me/messages/{message_id}/attachments

必需的参数	类型	说明
URL 参数
message_id	字符串	消息 ID。

备注

默认情况下，响应中的每个附件都包含与该附件类型对应的所有属性。使用 $select 仅指定那些你需要的属性，从而实现最佳性能。始终返回 Id 属性。请参阅 OData 查询参数，了解筛选、排序和分页参数。

响应类型

一个附件集合，其类型可以为 FileAttachment 或 ItemAttachment。

示例请求和响应

以下示例显示如何使用 $select 指定在响应中仅返回每个文件附件的名称属性。请参阅获取附件中的示例回应，以了解当您不使用 $select 时为一个附件返回的完整属性列表。

示例请求

GET https://outlook.office.com/api/v1.0/me/messages/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA=/attachments?$select=Name

示例响应

状态代码：200

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages('AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA%3D')/Attachments",
  "value": [
    {
      "@odata.type": "#Microsoft.OutlookServices.FileAttachment",
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAABEgAQANQEWV4bM8FIlPwxj4kShdM=",
      "Name": "minutes.docx",
      "ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "Size": 11585,
      "IsInline": false,
      "DateTimeLastModified": "2014-10-20T00:41:52Z",
      "ContentId": null,
      "ContentLocation": null,
      "IsContactPhoto": false,
      "ContentBytes": "UEsDBBQABgAIAAAAIQDCAAA4KQAAAAA="
    }
  ]
}

以下示例显示获取 Outlook 邮件项目的唯一附件。该响应包括附件 ID，该附件 ID 也是附加消息的 ID。

GET https://outlook.office.com/api/v1.0/me/messages('AAMkADFiNTPAAA=')/attachments

Content-Type: application/json

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages('AAMkADFiNTPAAA%3D')/Attachments",
  "value": [
    {
      "@odata.type": "#Microsoft.OutlookServices.ItemAttachment",
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-20075df800e5@1717622f-1d94-4d0c-9d74-f907ad6677b4')/Messages('AAMkADFiNTPAAA=')/Attachments('AAMkADFiNTAUhhYuYi0=')",
      "Id": "AAMkADFiNTAUhhYuYi0=",
      "Name": "How to retrieve item attachment using Outlook REST API",
      "ContentType": message/rfc822,
      "Size": 71094,
      "IsInline": false,
      "DateTimeLastModified": "2015-09-24T05:57:59Z",
    }
  ]
}

获取附件

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.read
wl.imap

获取特定消息的附件

GET https://outlook.office.com/api/v1.0/me/messages/{message_id}/attachments/{attachment_id}

备注

请参阅 OData 查询参数，了解筛选、排序和分页参数。

必需的参数	类型	说明
URL 参数
message_id	字符串	消息 ID。
attachment_id	字符串	附件 ID。

备注

默认情况下，响应包含附件的所有属性。使用 $select 仅指定那些你需要的属性，从而实现最佳性能。请参阅示例的获取附件集合。始终返回该 ID 属性。请参阅 OData 查询参数，了解筛选、排序和分页参数。

响应类型

请求的文件附件或项目附件。

示例请求

GET https://outlook.office.com/api/v1.0/me/messages/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA=/attachments/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAABEgAQANQEWV4bM8FIlPwxj4kShdM=

示例响应

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages('AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA%3D')/Attachments/$entity",
  "@odata.type": "#Microsoft.OutlookServices.FileAttachment",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGI2j4kShdM=",
  "Name": "minutes.docx",
  "ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "Size": 11585,
  "IsInline": false,
  "DateTimeLastModified": "2014-10-20T00:41:52Z",
  "ContentId": null,
  "ContentLocation": null,
  "IsContactPhoto": false,
  "ContentBytes": "UEsDBBQABgAIAAAAIQDCAAA4KQAAAAA=",
}

创建附件

你可以创建一个文件附件或创建一个消息项目附件。

创建文件附件
创建项目附件
创建参考附件

创建文件附件

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

添加文件附件到消息。

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/attachments

必需的参数	类型	说明
URL 参数
message_id	字符串	消息 ID。
正文参数
@odata.type	字符串	`#Microsoft.OutlookServices.FileAttachment`
名称	字符串	附件的名称。
ContentBytes	二进制	要附加的文件。

在请求正文中指定 Name 和 ContentBytes 参数以及任何可写文件附件属性。

响应类型

新文件附件。

创建项目附件

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

将一个项目附件添加到消息。

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/attachments

必需的参数	类型	说明
URL 参数
message_id	字符串	消息 ID。
正文参数
@odata.type	字符串	`#Microsoft.OutlookServices.ItemAttachment`
名称	字符串	附件的名称。
项	一个消息或者事件实体。	要附加的项。

在请求正文中指定名称和项目参数以及任何可写项目附件属性。

响应类型

新项目附件。

创建参考附件

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

将引用附件添加到消息。

这个功能目前仅在 beta 版中可用。要了解详细信息，请在左侧的目录中转到 Office 365 REST API 参考部分，并选择 beta。

删除附件

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

删除消息的指定附件。附件可以是文件附件或项目附件。

DELETE https://outlook.office.com/api/v1.0/me/messages/{message_id}/attachments/{attachment_id}

必需的参数	类型	说明
URL 参数
message_id	字符串	消息 ID。
attachment_id	字符串	附件 ID。

示例请求

DELETE https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8S-AAA=/attachments/AAMkAGE0Mg67gL7o=

示例响应

Status code: 204

获取文件夹

你可以获取文件夹集合或获取用户邮箱中的文件夹。

获取文件夹集合
获取文件夹

获取文件夹集合

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.read
wl.imap

获取登录用户 (.../me/folders) 的根文件夹下或指定的文件夹下的文件夹集合。你可以使用 .../me/folders 快捷方式获取顶级文件夹集合并导航到另一个文件夹。

GET https://outlook.office.com/api/v1.0/me/folders
GET https://outlook.office.com/api/v1.0/me/folders/{folder_id}/childfolders

备注

请参阅 OData 查询参数，了解筛选、排序和分页参数。

必需的参数	类型	说明
URL 参数
folder_id	字符串	文件夹 ID 或 `Inbox`、 `Drafts`、 `SentItems` 或者 `DeletedItems` 已知文件夹名（如果你正在从特定文件夹中获取文件夹）。

示例请求

GET https://outlook.office.com/api/v1.0/me/folders

示例响应

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders",
  "value": [
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEfAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Conversation Action Settings",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEKAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Deleted Items",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEPAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Drafts",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEMAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Inbox",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEQAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Journal",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEeAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Junk Email",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAERAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Notes",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAELAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Outbox",
      "ChildFolderCount": 0
    }
  ]
}

响应类型

请求的文件夹集合。

获取文件夹

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.read
wl.imap

通过 ID 获取文件夹。

GET https://outlook.office.com/api/v1.0/me/folders/{folder_id}

备注

请参阅 OData 查询参数，了解筛选、排序和分页参数。

必需的参数	类型	说明
URL 参数
folder_id	字符串	目标文件夹 ID，或者 `Inbox`、`Drafts`、`SentItems` 或 `DeletedItems` 已知文件夹的名称。

示例请求

GET https://outlook.office.com/api/v1.0/me/folders/inbox

示例响应

状态代码：200

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEJAAA=",
  "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
  "DisplayName": "Inbox",
  "ChildFolderCount": 0,
  "UnreadItemCount": 2,
  "TotalItemCount": 2
}

响应类型

请求的文件夹。

同步文件夹层次结构

这个功能目前在 v2.0 版和测试版可用。要了解详细信息，在左侧的目录转到 Office 365 REST API 引用部分，并选择以下版本之一。

创建文件夹

将新文件夹添加到文件夹集合。

创建文档夹

创建文档夹

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

按照 DisplayName 中指定的名称创建一个子文件夹。 DisplayName 是唯一可写的文件夹属性。

POST https://outlook.office.com/api/v1.0/me/folders/{folder_id}/childfolders

必需的参数	类型	说明
URL 参数
folder_id	字符串	目标文件夹 ID，或者 `Inbox`、`Drafts`、`SentItems` 或 `DeletedItems` 已知文件夹的名称。
正文参数
DisplayName	字符串	文件夹的显示名称。

示例请求

POST https://outlook.office.com/api/v1.0/me/folders/inbox/childfolders

Content-Type: application/json

{
  "DisplayName": "Company"
}

示例响应

状态代码：201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders('inbox')/ChildFolders/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=",
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAA=",
  "DisplayName": "Company",
  "ChildFolderCount": 0,
  "UnreadItemCount": 2,
  "TotalItemCount": 27
}

响应类型

新的文件夹。

备注

你无法创建顶级文件夹。你只能将文件夹添加到 childfolders 端点。

更新文件夹

更改文件夹名。

更新文件夹

更新文件夹

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

将文件夹名更改为 DisplayName 中指定的名称。该名称是文件夹的唯一可写属性。

PATCH https://outlook.office.com/api/v1.0/me/folders/{folder_id}

必需的参数	类型	说明
URL 参数
folder_id	字符串	目标文件夹 ID，或者 `Inbox`、`Drafts`、`SentItems` 或 `DeletedItems` 已知文件夹的名称。
正文参数
DisplayName	字符串	文件夹的新显示名称。

示例请求

PATCH https://outlook.office.com/api/v1.0/me/folders/AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=

Content-Type: application/json

{
  "DisplayName": "Business"
}

示例响应

状态代码：200

}
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=",
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAA=",
  "DisplayName": "Business",
  "ChildFolderCount": 0,
  "UnreadItemCount": 4,
  "TotalItemCount": 38
}

响应类型

更新的文件夹。

删除文件夹

删除一个文件夹及其所有内容。

备注

删除文件夹时要小心。已删除内容可能无法恢复。要了解更多信息，请参阅删除项目。

删除文件夹

删除文件夹

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

删除 folder_id 中指定的文件夹。

DELETE https://outlook.office.com/api/v1.0/me/folders/{folder_id}

必需的参数	类型	说明
URL 参数
folder_id	字符串	目标文件夹 ID，或者 `Inbox`、`Drafts`、`SentItems` 或 `DeletedItems` 已知文件夹的名称。

示例请求

DELETE https://outlook.office.com/api/v1.0/me/MailFolders/AAMkAGE0Mz-l_AAA=

示例响应

Status code: 204

移动或复制文件夹

你可以将文件夹移动或复制到另一个文件夹。

移动文件夹
复制文件夹

移动文件夹

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

通过使用移动方法将文件夹及其内容移动到另一个文件夹。

POST https://outlook.office.com/api/v1.0/me/folders/{folder_id}/move

必需的参数	类型	说明
URL 参数
folder_id	字符串	目标文件夹 ID，或者 `Inbox`、`Drafts`、`SentItems` 或 `DeletedItems` 已知文件夹的名称。
正文参数
DestinationId	字符串	目标文件夹 ID，或者 `Inbox`、`Drafts`、`SentItems` 或 `DeletedItems` 已知文件夹的名称。

示例请求

POST https://outlook.office.com/api/v1.0/me/folders/AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=/move

Content-Type: application/json

{
  "DestinationId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAOyxQ9AAA="
}

示例响应

状态代码：201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=",
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAOyxQ9AAA=",
  "DisplayName": "Business",
  "ChildFolderCount": 0,
  "UnreadItemCount": 4,
  "TotalItemCount": 38
}

响应类型

移动了的文件夹。

复制文件夹

最低要求的范围

以下各项之一：

https://outlook.office.com/mail.readwrite
wl.imap

通过使用复制方法将文件夹及其内容复制到另一个文件夹。

POST https://outlook.office.com/api/v1.0/me/folders/{folder_id}/copy

必需的参数	类型	说明
URL 参数
folder_id	字符串	目标文件夹 ID，或者 `Inbox`、`Drafts`、`SentItems` 或 `DeletedItems` 已知文件夹的名称。
正文参数
DestinationId	字符串	目标文件夹 ID，或者 `Inbox`、`Drafts`、`SentItems` 或 `DeletedItems` 已知文件夹的名称。

示例请求

POST https://outlook.office.com/api/v1.0/me/folders/AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=/copy

Content-Type: application/json

{
  "DestinationId": "inbox"
}

示例响应

状态代码：201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-mAAAA=",
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAA=",
  "DisplayName": "Business",
  "ChildFolderCount": 0,
  "UnreadItemCount": 4,
  "TotalItemCount": 38
}

响应类型

该文件夹的新副本。

后续步骤

无论你准备开始构建应用还是只想了解更多信息，我们都已为你考虑周全。

开始使用邮件、日历和联系人 REST API。
想要查看一些示例吗？我们就有。

或者，了解有关使用 Office 365 平台的更多信息：

通过

Outlook 邮件 REST API 的参考 （版本 1.0）

所有“邮件 API”操作

消息操作

文件夹操作

另请参阅

使用“邮件 REST API”

身份验证

API 版本

目标用户

获取消息

获取消息集合

最低要求的范围

示例请求

示例响应

响应类型

获取一封消息

最低要求的范围

示例请求

示例响应

响应类型

同步消息

创建并发送消息

即时发送新消息

最低要求的范围

示例请求

示例响应

创建草稿消息

最低要求的范围

示例请求

示例响应

响应类型

发送草稿消息

最低要求的范围

示例请求

示例响应

回复或全部回复消息

即时回复发件人

最低要求的范围

示例请求

示例响应

即时全部答复

最低要求的范围

示例请求

示例响应

创建回复消息草稿

最低要求的范围

示例请求

示例响应

响应类型

创建全部回复消息草稿

最低要求的范围

示例请求

示例响应

响应类型

转发新的消息或起草消息

直接转发草稿

最低要求的范围

示例请求

示例响应

创建转发消息的草稿

最低要求的范围

示例请求

示例响应

响应类型

更新消息

更新消息

最低要求的范围

示例请求

示例响应

响应类型

删除消息

删除消息

最低要求的范围

示例请求

示例响应

移动或复制消息

移动消息

最低要求的范围

示例请求

Outlook 邮件 REST API 的参考（版本 1.0）

获取语言选项（预览）