自动创建、发送和处理邮件

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

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

创建和发送邮件

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

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

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

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

设置 from 和 sender 属性

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

  • 如果 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 响应中返回的默认邮件正文类型。

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

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 实体之间共享的常用功能:

后续步骤