eventMessage 资源类型

命名空间：microsoft.graph

重要

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

表示会议请求、取消或响应（可以是下列任一行为：接受、暂定接受或拒绝）的邮件。

eventMessage 实体派生自 message。 eventMessage 是 eventMessageRequest 和 eventMessageResponse 的基类型。 meetingMessageType 属性确定事件邮件类型。

当组织者或应用发送会议请求时，会议请求将作为 eventMessage 实例到达被邀请者的邮箱中，其中包含 meetingRequest 的 meetingMessageType。 此外，Outlook 会在被邀请人的日历中自动创建事件实例，其中 showAs 属性为暂定。

若要获取被邀请者邮箱中关联事件的属性，应用可以使用 eventMessage的事件导航属性，如此 get 事件消息示例所示。 应用还可以通过 接受、 暂时接受或 拒绝 事件，以编程方式代表被邀请者响应事件。

除了会议请求之外，事件组织者取消会议的结果，可以在被邀请者的邮箱中找到 eventMessage 实例，或者在被邀请者响应会议请求后在组织者的邮箱中找到 eventMessage 实例。 应用可以对事件邮件执行操作，就像对邮件执行操作一样，但略有不同。

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": "DateTimeOffset",
  "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "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",
  "isAllDay": "Boolean",
  "isDelegated": true,
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isOutOfDate": "Boolean",
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "DateTimeOffset",
  "location": {"@odata.type": "microsoft.graph.location"},
  "meetingMessageType": {"@odata.type": "microsoft.graph.meetingMessageType"},
  "mentionsPreview": {"@odata.type": "microsoft.graph.mentionsPreview"},
  "parentFolderId": "string",
  "receivedDateTime": "DateTimeOffset",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "DateTimeOffset",
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "type": "string",
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "UnsubscribeData": "string",
  "UnsubscribeEnabled": true,
  "webLink": "string"
}

属性

属性	类型	说明
bccRecipients	recipient collection	邮件的密件抄送收件人。
body	itemBody	邮件的正文。 可以是 HTML 格式或文本格式。
bodyPreview	String	邮件正文中的前 255 个字符。 文本格式。
categories	String collection	与邮件关联的类别。
ccRecipients	recipient collection	邮件的抄送收件人。
changeKey	String	邮件的版本。
conversationId	String	电子邮件所属对话的 ID。
conversationIndex	Edm.Binary	指出消息在对话中的位置。
createdDateTime	DateTimeOffset	创建邮件的日期和时间。
endDateTime	dateTimeTimeZone	请求的会议结束时间。
flag	followupFlag	指示邮件的状态、开始日期、截止日期或完成日期的标志值。
发件人	recipient	发送邮件邮箱的所有者。 在多数情况中，此数值与“发件人”属性相同，但共享或委派情景除外。 值必须对应于使用的实际邮箱。 查看更多有关为邮件设置 from 和 sender 属性的信息。
hasAttachments	Boolean	指示邮件是否包含附件。
id	String	邮件的唯一标识符。 默认情况下，当项从一个容器（如文件夹或日历）移动到另一个容器时，此值会更改。 若要更改此行为，请使用 Prefer: IdType="ImmutableId"头。 有关详细信息，请参阅获取 Outlook 资源的不可变标识符。 只读。
importance	String	邮件的重要性：low、normal、high。
inferenceClassification	String	可取值为：focused、other。
internetMessageHeaders	internetMessageHeader 集合	由 RFC5322 定义的邮件头集合，它提供邮件获取的从发件人到收件人的网络路径的详细信息。 只读。
internetMessageId	String	邮件 ID 采用 RFC5322 指定的格式。
isAllDay	Boolean	指示事件是否持续一整天。 调整此属性还需要调整事件的 startDateTime 和 endDateTime 属性。
isDelegated	布尔值	如果代理人可以访问此会议请求，则为 True;否则为 false。 默认为 false。
isDeliveryReceiptRequested	Boolean	指示是否需要发送邮件已读回执。
isDraft	Boolean	指示邮件是否为草稿。 如果尚未发送，则此邮件是一封草稿。
isOutOfDate	布尔值	指示此会议请求是否已由较新的请求过期。
isRead	Boolean	指示是否已阅读该邮件。
isReadReceiptRequested	Boolean	指示是否需要发送邮件已读回执。
lastModifiedDateTime	DateTimeOffset	上次更改邮件的日期和时间。
位置	位置	请求的会议位置。
meetingMessageType	String	事件消息的类型：none、meetingRequest、meetingCancelled、meetingAccepted、meetingTentativelyAccepted、meetingDeclined。
mentionsPreview	mentionsPreview	邮件中的提及的相关信息。 处理 GET /messages 请求时，服务器会设置此属性并默认将其包含在响应中。 若邮件中无提及，则服务器返回 NULL。 可选。
parentFolderId	String	邮件的父 MailFolder 的唯一标识符。
receivedDateTime	DateTimeOffset	收到邮件的日期和时间。
recurrence	patternedRecurrence	所请求会议的重复模式。
replyTo	recipient collection	在答复时使用的电子邮件地址。
sender	recipient	实际用于生成邮件的帐户。 大多数情况下，此值与“from”属性相同。 从共享邮箱发送邮件时，可以将此属性设置为其他值，对于共享日历，或设置为代理人。 在任何情况下，此值必须对应于使用的实际邮箱。 查看更多有关为邮件设置 from 和 sender 属性的信息。
sentDateTime	DateTimeOffset	发送邮件的日期和时间。
startDateTime	dateTimeTimeZone	请求的会议开始时间。
subject	String	邮件的主题。
toRecipients	recipient collection	邮件的收件人。
type	String	请求的会议类型： singleInstance、 occurence、 exception、 seriesMaster。
uniqueBody	itemBody	当前邮件专用的邮件正文部分。
UnsubscribeData	String	从 List-Unsubscribe 标头中解析的有效条目。 若 UnsubscribeEnabled 属性为 true，则这是 List-Unsubscribe 标头中的邮件命令的数据。
UnsubscribeEnabled	布尔值	指示邮件是否已启用取消订阅。 若 list-Unsubscribe 标头符合 rfc-2369，则其值为 True。
webLink	String	要在 Outlook 网页版中打开邮件的 URL。 可以将 ispopout 参数附加到此 URL 的末尾以更改邮件的显示方式。 如果 ispopout 不存在或设置为 1，则邮件显示在弹出窗口中。 如果 ispopout 设置为 0，则浏览器将在 Outlook 网页版的审阅窗格中显示邮件。 如果通过 Outlook 网页版登录邮箱，该邮件将在浏览器中打开。 如果尚未使用浏览器登录，系统将提示你登录。 无法从 iFrame 中访问此 URL。

关系

关系	类型	说明
attachments	附件集合	邮件的 fileAttachment、 itemAttachment 和 referenceAttachment 附件的集合。 此为只读属性。 可为 Null。
event	event	与事件消息相关联的事件。 对于与会者或会议室资源，假定已将日历助理设为在会议请求事件消息到达时自动更新包含事件的日历。 导航属性。 只读。
extensions	extension 集合	为 eventMessage 定义的开放扩展集合。 只读。 可为空。
提及	mention 集合	邮件中的提及集合，按 createdDateTime 由最新到最旧排序。 默认情况下，GET /messages 不会返回此属性，在该属性上应用 $expand 时除外。
multiValueExtendedProperties	multiValueLegacyExtendedProperty 集合	为 eventMessage 定义的多值扩展属性的集合。 只读。 可为 Null。
singleValueExtendedProperties	singleValueLegacyExtendedProperty collection	为 eventMessage 定义的单值扩展属性的集合。 只读。 可为 Null。

方法

方法	返回类型	说明
获取 eventMessage	eventMessage	读取 eventmessage 对象的属性和关系。
更新	eventMessage	更新 eventMessage 对象。
删除	无	更新 eventMessage 对象。
copy	message	将邮件复制到文件夹。
createForward	message	创建转发邮件的草稿。 然后，你可以 更新 或 发送 草稿。
createReply	message	创建回复邮件的草稿。 然后，你可以 更新 或 发送 草稿。
createReplyAll	message	创建全部答复邮件的草稿。 然后，你可以 更新 或 发送 草稿。
转发	无	转发邮件。 然后邮件保存在已发送邮件文件夹中。
move	message	将邮件移动到文件夹。 该操作会在目标文件夹中创建邮件的新副本。
回复	无	答复邮件的发件人。 然后邮件保存在已发送邮件文件夹中。
全部回复	无	答复邮件的所有收件人。 然后邮件保存在已发送邮件文件夹中。
发送	无	发送以前创建的邮件草稿。 然后邮件保存在已发送邮件文件夹中。
取消订阅	无	使用 List-Unsubscribe 标头中的第一个 mailto 命令中指定的数据和地址发送邮件。
附件
列出附件	attachment 集合	获取 eventMessage 的所有附件。
Add attachment	attachment	通过发布到附件集合，向 eventMessage 添加新附件。
开放扩展
创建开放扩展	openTypeExtension	创建开放扩展，并在新建或现有的资源实例中添加自定义属性。
获取开放扩展	openTypeExtension 集合	获取按名称标识的开放扩展。
扩展属性
创建单值扩展属性	eventMessage	在新建或现有 eventMessage 中创建一个或多个单值扩展属性。
获取具有单值扩展属性的 eventMessage	eventMessage	通过使用 $expand 或 $filter 获取包含单值扩展属性的 eventMessage。
创建多值扩展属性	eventMessage	在新建或现有的 eventMessage 中创建一个或多个多值扩展属性。
获取具有多值扩展属性的 eventMessage	eventMessage	使用 $expand 获取包含一个多值扩展属性的 eventMessage。