eventMessage 资源类型
命名空间：microsoft.graph
表示会议请求、取消或响应（可以是下列任一行为：接受、暂定接受或拒绝）的邮件。
eventMessage 实体派生自 message。 eventMessage 是 eventMessageRequest 和 eventMessageResponse 的基类型。 meetingMessageType 属性确定事件邮件类型。
当组织者或应用发送会议请求时，会议请求将作为 eventMessage 实例到达被邀请者的邮箱中，其中包含 meetingRequest 的 meetingMessageType。 此外，Outlook 会在被邀请人的日历中自动创建事件实例，其中 showAs 属性为暂定。
若要获取被邀请者邮箱中关联事件的属性，应用可以使用 eventMessage的事件导航属性，如此 get 事件消息示例所示。 应用还可以通过 接受、 暂时接受或 拒绝 事件，以编程方式代表被邀请者响应事件。
除了会议请求之外，事件组织者取消会议的结果，可以在被邀请者的邮箱中找到 eventMessage 实例，或者在被邀请者响应会议请求后在组织者的邮箱中找到 eventMessage 实例。 应用可以对事件邮件执行操作，就像对邮件执行操作一样，但略有不同。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 获取事件消息 | eventMessage | 读取 eventmessage 对象的属性和关系。 |
| 更新事件消息 | eventMessage | 更新 eventMessage 对象。 |
| 删除邮件 | 无 | 更新 eventMessage 对象。 |
| 复制邮件 | 邮件 | 将邮件复制到文件夹。 |
| Create草稿以转发邮件 | 邮件 | 创建转发邮件的草稿。 然后，你可以 更新 或 发送 草稿。 |
| Create草稿进行答复 | 邮件 | 创建回复邮件的草稿。 然后，你可以 更新 或 发送 草稿。 |
| Create草稿以全部答复 | 邮件 | 创建全部答复邮件的草稿。 然后，你可以 更新 或 发送 草稿。 |
| 转发邮件 | 无 | 转发邮件。 然后邮件保存在已发送邮件文件夹中。 |
| 移动消息 | 邮件 | 将邮件移动到文件夹。 该操作会在目标文件夹中创建邮件的新副本。 |
| 答复邮件 | 无 | 答复邮件的发件人。 然后邮件保存在已发送邮件文件夹中。 |
| 全部答复邮件 | 无 | 答复邮件的所有收件人。 然后邮件保存在已发送邮件文件夹中。 |
| 发送草稿消息 | 无 | 发送以前创建的邮件草稿。 然后邮件保存在已发送邮件文件夹中。 |
| 附件 | ||
| 列出附件 | attachment 集合 | 获取 eventMessage 的所有附件。 |
| Add attachment | attachment | 通过发布到附件集合，向 eventMessage 添加新附件。 |
| 开放扩展 | ||
| 创建开放扩展 | openTypeExtension | 创建开放扩展，并在新建或现有的资源实例中添加自定义属性。 |
| 获取开放扩展 | openTypeExtension 集合 | 获取通过名称或完全限定的名称识别的一个或多个开放扩展对象。 |
| 扩展属性 | ||
| 创建单值属性 | eventMessage | 在新建或现有 eventMessage 中创建一个或多个单值扩展属性。 |
| 获取单值属性 | eventMessage | 通过使用 $expand 或 $filter 获取包含单值扩展属性的 eventMessage。 |
| Create多值属性 | eventMessage | 在新建或现有的 eventMessage 中创建一个或多个多值扩展属性。 |
| 获取多值属性 | eventMessage | 使用 $expand 获取包含一个多值扩展属性的 eventMessage。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 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 | 创建邮件的日期和时间。 |
| 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 | 由 RFC2822 指定格式的邮件 ID。 |
| isDelegated | 布尔值 | 如果代理人可以访问此会议请求，则为 True;否则为 false。 默认为 false。 |
| isDeliveryReceiptRequested | Boolean | 指示是否需要发送邮件已读回执。 |
| isDraft | Boolean | 指示邮件是否为草稿。 如果尚未发送，则此邮件是一封草稿。 |
| isRead | Boolean | 指示是否已阅读该邮件。 |
| isReadReceiptRequested | Boolean | 指示是否需要发送邮件已读回执。 |
| lastModifiedDateTime | DateTimeOffset | 上次更改邮件的日期和时间。 |
| meetingMessageType | meetingMessageType | 事件消息的类型：none、meetingRequest、meetingCancelled、meetingAccepted、meetingTenativelyAccepted、meetingDeclined。 |
| parentFolderId | String | 邮件的父 MailFolder 的唯一标识符。 |
| receivedDateTime | DateTimeOffset | 收到邮件的日期和时间。 |
| replyTo | recipient collection | 在答复时使用的电子邮件地址。 |
| sender | recipient | 实际用于生成邮件的帐户。 大多数情况下，此值与“from”属性相同。 从共享邮箱发送邮件时，可以将此属性设置为其他值，对于共享日历，或设置为代理人。 在任何情况下，此值必须对应于使用的实际邮箱。 查看更多有关为邮件设置 from 和 sender 属性的信息。 |
| sentDateTime | DateTimeOffset | 发送邮件的日期和时间。 |
| subject | String | 邮件的主题。 |
| toRecipients | recipient collection | 邮件的收件人。 |
| uniqueBody | itemBody | 当前邮件专用的邮件正文部分。 |
| webLink | String | 要在 Outlook 网页版中打开邮件的 URL。 可以将 ispopout 参数附加到此 URL 的末尾以更改邮件的显示方式。 如果 ispopout 不存在或设置为 1，则邮件显示在弹出窗口中。 如果 ispopout 设置为 0，则浏览器将在 Outlook 网页版的审阅窗格中显示邮件。 如果通过 Outlook 网页版登录邮箱，该邮件将在浏览器中打开。 如果尚未使用浏览器登录，系统将提示你登录。 无法从 iFrame 中访问此 URL。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| attachments | attachment 集合 | 此为只读属性。 可为 Null。 |
| event | event | 与事件消息相关联的事件。 对于与会者或会议室资源，假定已将日历助理设为在会议请求事件消息到达时自动更新包含事件的日历。 导航属性。 只读。 |
| extensions | extension 集合 | 为 eventMessage 定义的开放扩展集合。 只读。 可为 Null。 |
| multiValueExtendedProperties | multiValueLegacyExtendedProperty 集合 | 为 eventMessage 定义的多值扩展属性的集合。 只读。 可为 Null。 |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty collection | 为 eventMessage 定义的单值扩展属性的集合。 只读。 可为 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": "DateTimeOffset",
"event": { "@odata.type": "microsoft.graph.event" },
"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",
"isDelegated": true,
"isDeliveryReceiptRequested": true,
"isDraft": true,
"isRead": true,
"isReadReceiptRequested": true,
"lastModifiedDateTime": "DateTimeOffset",
"meetingMessageType": "String",
"parentFolderId": "string",
"receivedDateTime": "DateTimeOffset",
"replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
"sender": {"@odata.type": "microsoft.graph.recipient"},
"sentDateTime": "DateTimeOffset",
"subject": "string",
"toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
"webLink": "string"
}