邮件资源类型

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

邮箱文件夹中的邮件。

从 Exchange Online 邮箱发送的单个电子邮件的 toRecipientsccRecipientsbccRecipients 属性包含的最大收件人数为 500。 有关详细信息,请参阅发送限制

该资源支持:

  • 将你自己的数据添加为自定义 Internet 邮件头。 仅在创建邮件时添加自定义邮件头,并以“x-”开头命名。 发送消息后,无法修改标头。 若要获取邮件头,请在获取邮件操作中应用 $select 查询参数。
  • 将你自己的数据作为扩展添加到自定义属性。
  • 订阅更改通知
  • 通过提供 delta 函数,使用 delta 查询跟踪增量添加、删除和更新。

方法

方法 返回类型 说明
列出邮件 邮件集合 获取已登录用户的邮箱中的所有邮件(包括“已删除邮件”和“待筛选邮件”文件夹)。
创建草稿邮件 邮件 创建新邮件的草稿。
获取邮件 邮件 读取 message 对象的属性和关系。
更新邮件 邮件 更新 message 对象。
删除邮件 删除 message 对象。
复制邮件 邮件 将邮件复制到文件夹。
创建草稿以转发邮件 邮件 创建转发邮件草稿以全部在一个 createForward 调用中添加注释或更新任意邮件属性。 然后,你可以更新发送草稿。
创建要答复的草稿 邮件 创建回复邮件草稿以全部在一个 createReply 调用中添加注释或更新任意邮件属性。 然后,你可以更新发送草稿。
创建草稿以答复全部 邮件 创建回复全部邮件草稿以全部在一个 createReplyAll 调用中添加注释或更新任意邮件属性。 然后,你可以更新发送草稿。
获取消息 Delta message 集合 获取在指定文件夹中添加、删除或更新的一组邮件。
转发邮件 None 全部在一个 forward 调用中转发邮件、添加注释或修改任意可更新的属性。 然后邮件保存在已发送邮件文件夹中。
标记为垃圾邮件 邮件 邮件 标记为垃圾邮件。 当 moveToJunktrue时,此 API 会将发件人添加到阻止的发件人列表中,并将邮件移动到“垃圾邮件”文件夹。
标记为非垃圾邮件 邮件 邮件 标记为非垃圾邮件。 当 moveToInboxtrue时,此 API 会从阻止的发件人列表中删除发件人,并将邮件移动到“收件箱”文件夹。
移动消息 邮件 将邮件移动到文件夹。 此 API 在目标文件夹中创建邮件的新副本。
回复消息 None 全部在一个 reply 调用中回复邮件的发件人、添加注释或修改任意可更新的属性。 然后邮件保存在已发送邮件文件夹中。
全部答复邮件 None 通过指定注释和修改回复的任意可更新属性来回复邮件的所有收件人,全部通过使用 replyAll 方法实现。 然后邮件保存在已发送邮件文件夹中。
发送草稿消息 None 发送以前创建的邮件草稿。 然后邮件保存在已发送邮件文件夹中。
撤回邮件 邮件 撤回指定用户的邮箱“已发送邮件”文件夹中的邮件。
取消订阅 使用 List-Unsubscribe 标头中的第一个 mailto 命令中指定的数据和地址发送邮件。
永久删除 None 永久删除邮件并将其放置在用户邮箱的“可恢复邮件”文件夹中的“清除”文件夹中。
附件
列出附件 Attachment 集合 获取邮件的所有附件。
添加附件 Attachment 通过发布到附件集合,向邮件添加新附件。
开放扩展
创建开放扩展 openTypeExtension 创建开放扩展,并将自定义属性添加到新资源或现有资源。
获取开放扩展 openTypeExtension 集合 获取扩展名称标识的开放扩展。
扩展属性
创建单值属性 邮件 在新建或现有的邮件中创建一个或多个单值扩展属性。
获取单值属性 邮件 通过使用 $expand$filter 获取包含单值扩展属性的邮件。
创建多值属性 邮件 在新建或现有的邮件中创建一个或多个多值扩展属性。
获取多值属性 邮件 使用 $expand 获取包含一个多值扩展属性的邮件。

属性

属性 类型 说明
bccRecipients recipient collection 邮件的密件抄送收件人。
body itemBody 邮件的正文。 可以是 HTML 格式或文本格式。 查看有关邮件正文中的安全 HTML的信息。
bodyPreview String 邮件正文中的前 255 个字符。 文本格式。 如果消息包含 mention 实例,该属性也包含这些提及内容的串联。
ccRecipients recipient collection 邮件的抄送收件人。
changeKey String 邮件的版本。
conversationId String 电子邮件所属对话的 ID。
conversationIndex Edm.Binary 指出消息在对话中的位置。
createdDateTime DateTimeOffset 创建邮件的日期和时间。

日期和时间信息采用 ISO 8601 格式,并且始终处于 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
flag followupFlag 指示邮件的状态、开始日期、截止日期或完成日期的标志值。
发件人 recipient 发送邮件邮箱的所有者。 在多数情况中,此数值与“发件人”属性相同,但共享或委派情景除外。 值必须对应于使用的实际邮箱。 查看更多有关为邮件设置 from 和 sender 属性的信息。
hasAttachments Boolean 指示邮件是否包含附件。 此属性不包括内联附件,因此,如果邮件仅包含内联附件,则此属性为 false。 若要验证是否存在内联附件,请分析 body 属性以查找 src 属性,例如 <IMG src="cid:image001.jpg@01D26CD8.6C05F070">
id String 邮件的唯一标识符。 默认情况下,当项从一个容器(如文件夹或日历)移动到另一个容器时,此值会更改。 若要更改此行为,请使用 Prefer: IdType="ImmutableId"头。 有关详细信息,请参阅获取 Outlook 资源的不可变标识符。 只读。
importance importance 邮件的重要性。 可能的值为: lownormalhigh
inferenceClassification inferenceClassificationType 根据推导出的相关性或重要性或根据显式重写,对用户邮件的分类。 可取值为:focusedother
internetMessageHeaders internetMessageHeader 集合 RFC5322 定义的邮件头集合。 该集合包括指示邮件从发件人发送到收件人所采用的网络路径的邮件头。 还可以包含保存邮件应用数据的自定义邮件头。

仅在应用 $select 查询选项时返回。 只读。
internetMessageId String 邮件 ID 采用 RFC5322 指定的格式。 仅当 isDraft 为 true 时才更更新。
isDeliveryReceiptRequested Boolean 指示是否需要发送邮件已读回执。
isDraft Boolean 指示邮件是否为草稿。 如果尚未发送,则此邮件是一封草稿。
isRead Boolean 指示是否已阅读该邮件。
isReadReceiptRequested Boolean 指示是否需要发送邮件已读回执。
lastModifiedDateTime DateTimeOffset 上次更改邮件的日期和时间。

日期和时间信息采用 ISO 8601 格式,并且始终处于 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
mentionsPreview mentionsPreview 邮件中的提及的相关信息。 处理 GET /messages 请求时,服务器会设置此属性并默认将其包含在响应中。 若邮件中无提及,则服务器返回 NULL。 可选。
parentFolderId String 邮件的父 MailFolder 的唯一标识符。
receivedDateTime DateTimeOffset 收到邮件的日期和时间。

日期和时间信息采用 ISO 8601 格式,并且始终处于 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
replyTo recipient collection 在答复时使用的电子邮件地址。
sender recipient 实际用于生成邮件的帐户。 大多数情况下,此值与“from”属性相同。 从共享邮箱发送邮件时,可以将此属性设置为其他值,对于共享日历,或设置为代理人。 在任何情况下,此值必须对应于使用的实际邮箱。 查看更多有关为邮件设置 from 和 sender 属性的信息。
sentDateTime DateTimeOffset 发送邮件的日期和时间。

日期和时间信息采用 ISO 8601 格式,并且始终处于 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
subject String 邮件的主题。
toRecipients recipient collection 邮件的收件人。
uniqueBody itemBody 当前邮件专用的邮件正文部分。 默认情况下不返回 uniqueBody,但可以使用查询为给定消息?$select=uniqueBody检索。 可以是 HTML 格式或文本格式。
unsubscribeData String 从 List-Unsubscribe 标头中解析的有效条目。 若 UnsubscribeEnabled 属性为 true,则这是 List-Unsubscribe 标头中的邮件命令的数据。
unsubscribeEnabled Boolean 指示邮件是否已启用取消订阅。 若 list-Unsubscribe 标头符合 rfc-2369,则其值为 True。
webLink String 要在 Outlook 网页版中打开邮件的 URL。

可以将 ispopout 参数附加到此 URL 的末尾以更改邮件的显示方式。 如果 ispopout 不存在或设置为 1,则邮件显示在弹出窗口中。 如果 ispopout 设置为 0,浏览器会显示 Outlook 网页版审阅窗格中的邮件。

如果通过 Outlook 网页版登录到邮箱,将在浏览器中打开邮件。 如果尚未使用浏览器登录,系统会提示你登录。

无法从 iFrame 中访问此 URL。

关系

关系 类型 说明
attachments 附件 集合 邮件的 fileAttachmentitemAttachment 附件。
extensions Extension 集合 为邮件定义的开放扩展集合。 可为空。
提及 mention 集合 邮件中的提及集合,按 createdDateTime 由最新到最旧排序。 默认情况下,GET /messages 不会返回此属性,在该属性上应用 $expand 时除外。
multiValueExtendedProperties multiValueLegacyExtendedProperty 集合 为邮件定义的多值扩展属性的集合。 可为空。
singleValueExtendedProperties singleValueLegacyExtendedProperty collection 为邮件定义的单值扩展属性的集合。 可为 Null。

JSON 表示形式

下面是资源的 JSON 表示形式

{
  "bccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "categories": ["string"],
  "ccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "changeKey": "string",
  "conversationId": "string",
  "conversationIndex": "String (binary)",
  "createdDateTime": "String (timestamp)",
  "flag": {"@odata.type": "microsoft.graph.followupFlag"},
  "from": {"@odata.type": "microsoft.graph.recipient"},
  "hasAttachments": true,
  "id": "string (identifier)",
  "importance": "String",
  "inferenceClassification": "String",
  "internetMessageHeaders": [{"@odata.type": "microsoft.graph.internetMessageHeader"}],
  "internetMessageId": "String",
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "String (timestamp)",
  "mentionsPreview": {"@odata.type": "microsoft.graph.mentionsPreview"},
  "parentFolderId": "string",
  "receivedDateTime": "String (timestamp)",
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "String (timestamp)",
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "unsubscribeData": "string",
  "unsubscribeEnabled": true,
  "webLink": "string",

  "attachments": [{"@odata.type": "microsoft.graph.attachment"}],
  "extensions": [{"@odata.type": "microsoft.graph.extension"}],
  "mentions": [{"@odata.type": "microsoft.graph.mention"}],
  "multiValueExtendedProperties": [{"@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty"}],
  "singleValueExtendedProperties": [{"@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty"}]
}