大网数据广告活动
Microsoft Graph 接口

使用 Outlook 邮件 API 自动创建、发送、处理邮件

· 52CE 我爱测

电子邮件由 Microsoft Graph 中 Outlook 邮件 API 中的邮件资源表示。 你可以创建和发送邮件、检查收件人状态等。

电子邮件通过 Microsoft Graph 中的邮件资源表示。

默认情况下,邮件由 ID 属性中的唯一条目 ID 标识。 当最初创建、保存为草稿或发送邮件时,存储提供程序会为邮件分配一个条目 ID。 默认情况下,当将邮件复制或移动到另一个文件夹、存储空间或 .PST 文件时,该 ID 会发生变化。 可以通过当前 ID 引用邮件,以便后续处理。

创建和发送邮件

在 Outlook 中,你可以在同一 sendMail 操作中创建和发送电子邮件,或者可以创建草稿,然后添加内容并发送此草稿。

同样,在回复电子邮件时,也可以使用相同的操作(答复、全部答复或转发)创建和发送响应。 或者,你可以为响应(答复、全部答复或转发)创建草稿,添加内容),然后稍后发送此草稿。

要以编程方式区分草稿和已发送邮件,请选中 isDraft 属性。

默认情况下,草稿邮件保存在 Drafts 文件夹中,已发送邮件保存在 Sent Items 文件夹中。 为方便起见,可以通过相应的已知文件夹名称来识别 Drafts 文件夹和 SentItems 文件夹。

设置 from 和 sender 属性

撰写邮件时,在大多数情况下,Outlook 会将 from 和 sender 属性设置为同一登录用户。可以在以下方案中更新这些属性:

  • 如果 Exchange 管理员已将邮箱的 sendAs 权限分配给其他一些用户,可以更改 from 属性。为此,管理员可以在 Azure 门户中选择邮箱所有者的 邮箱权限,也可以使用 Exchange 管理中心或 Windows PowerShell Add-ADPermission cmdlet。然后,可以编程方式将 from 属性设置为,对相应邮箱拥有 sendAs 权限的用户之一。
  • 如果邮箱所有者已委派一个或多个用户能够从该邮箱发送邮件,则可以更改 Sender 属性。邮箱所有者可以在 Outlook 中委派。当代理代表邮箱所有者发送邮件时,Outlook 将 Sender 属性设置为代理的帐户,而 from 属性仍保持为邮箱所有者。可以通过编程方式将 Sender 属性设置为拥有该邮箱代理权限的用户。

使用邮件提醒检查收件人状态并节省时间(预览版)

使用 邮件提醒 以在发送电子邮件之前做出明智决策。邮件提醒可以告诉你信息,例如收件人的邮箱仅限于特定发件人,或者向该收件人发送电子邮件需要审批。

阅读邮件并控制返回的正文格式

可以通过引用邮件 ID 来阅读邮箱中的邮件:

GET /me/messages/AAMkADhMGAAA=

或者,也可以获取特定文件夹中的邮件。 例如,阅读单点登录用户的“草稿”文件夹中的邮件:

GET /me/mailfolders('Drafts')

Outlook 邮件正文可以是 HTML 或文本,其中 HTML 作为 GET 响应中返回的默认邮件正文类型。

获取邮件时,你可以指定以下请求标头以文本格式返回 body 和 uniqueBody 属性:

Prefer: outlook.body-content-type="text"

你可以指定以下标头(或直接跳过标头),以 HTML 格式获取邮件正文:

Prefer: outlook.body-content-type="html"

当指定任一标头时,成功的响应将包含相应的 Preference-Applied 标头:

  • 对于文本格式请求:Preference-Applied: outlook.body-content-type="text"
  • 对于 HTML 格式请求:Preference-Applied: outlook.body-content-type="html"

默认情况下,如果正文是 HTML 格式,那么在 REST 响应中返回正文内容之前,Outlook 将删除嵌入 body 属性中的任何具有潜在不安全性的 HTML(例如 JavaScript)。

若要获取整个原始 HTML 内容,请包括以下 HTTP 请求标头:

Prefer: outlook.allow-unsafe-html

与“@”社交手势集成(预览版)

@-mention 是提醒用户邮件中是否有提到他们的通知。 mention资源使应用能够在电子邮件中设置和获取常见的在线社交手势,即“@”前缀。 可以执行下列操作:

其他共享的功能

利用以下在 Microsoft Graph 实体之间共享的常用功能:

后续步骤

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 abheek-das)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。