事件资源类型

命名空间:microsoft.graph

重要

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

用户日历或 Microsoft 365 默认日历中的事件。

事件中包含的最大与会者人数,以及发送自 Exchange Online 邮箱的 eventMessage 中的收件人数上限都是 500 人。 有关详细信息,请参阅发送限制

该资源支持:

注释:与用户日历、组日历及其事件交互的方式稍有不同:

  • 只可以组织 calendarGroup 中的用户日历。
  • 只能将 attachment 对象添加到用户日历中的事件,而不能添加到组日历中的事件。
  • Outlook 将代表组自动接受所有会议请求。 只能接受暂时接受拒绝用户日历的会议请求。
  • Outlook 不支持对组事件提供提醒。 只可以暂停消除用户日历中的提醒

方法

方法 返回类型 说明
列出事件 Event 集合 检索用户邮箱中的 event 对象列表。 该列表包含单个实例会议和系列主控形状。
Create event 事件 通过发布到实例集合创建新事件。
获取事件 事件 读取 event 对象的属性和关系。
更新事件 事件 更新事件对象。
删除事件 删除 event 对象。
获取增量 事件集合 获取用户主日历的 calendarView(事件范围)中已添加、删除或更新的事件集。
转发事件 让会议事件的组织者或与会者可以将会议请求转发给新的收件人。
取消事件 将取消消息从组织者发送至所有与会者,并取消指定会议。
Accept 事件 接受用户日历中的指定事件。
暂时接受 暂时接受用户日历中的指定事件。
拒绝事件 拒绝用户日历中的指定事件邀请。
关闭提醒 消除用户日历中指定事件的提醒。
推迟提醒 将用户日历中指定事件的提醒推迟至新的时间。
列出事件实例 Event 集合 获取 Event 对象集合。
附件
列出附件 Attachment 集合 获取事件的所有附件。
Add attachment 附件 通过发布到附件集合,向事件添加新附件。
开放扩展
创建开放扩展 openTypeExtension 创建开放扩展,并将自定义属性添加到新资源或现有资源。
获取开放扩展 openTypeExtension 集合 获取扩展名称标识的开放扩展。
扩展属性
创建单值属性 事件 在新建或现有事件中创建一个或多个单值扩展属性。
获取单值属性 事件 通过使用 $expand$filter 获取包含单值扩展属性的事件。
创建多值属性 事件 在新建或现有的事件中创建一个或多个多值扩展属性。
获取多值属性 事件 使用 $expand 获取包含一个多值扩展属性的事件。

属性

属性 类型 说明
allowNewTimeProposals 布尔值 true 如果会议组织者允许被邀请者在答复时建议新时间,则为 ;否则为 false。 可选。 默认值为 true
attendees Attendee 集合 事件的与会者集合。
body ItemBody 与事件相关联的邮件正文。 可以是 HTML 格式或文本格式。
bodyPreview String 与事件相关联的邮件预览。 文本格式。
categories String collection 与事件相关联的类别。 每个类别对应于为用户定义的 outlookCategorydisplayName 属性。
changeKey String 标识 event 对象的版本。 每次事件更改时,ChangeKey 也将更改。 这样,Exchange 可以将更改应用于该对象的正确版本。
createdDateTime DateTimeOffset 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
end DateTimeTimeZone 事件结束的日期、时间和时区。 默认情况下,结束时间为 UTC 时间。
hasAttachments Boolean 如果事件包含附件,则设置为 true。
hideAttendees 布尔值 如果设置为 true,则每个与会者仅会在会议请求和会议 跟踪 列表中看到自己。 默认值为 false。
iCalUId 字符串 跨日历事件的唯一标识符。 此 ID 对于定期系列中的每个单一事件来说是不同的。 只读。
id String 事件的唯一标识符。 默认情况下,当项从一个容器(如文件夹或日历)移动到另一个容器时,此值会更改。 若要更改此行为,请使用 Prefer: IdType="ImmutableId"头。 有关详细信息,请参阅获取 Outlook 资源的不可变标识符。 区分大小写和只读。
importance String 事件的重要性。 可能的值包括 lownormalhigh
isAllDay Boolean 如果事件持续一整天,则设置为 true。 如果为 true,无论是单天事件还是多天事件,都必须将开始和结束时间设置为午夜,并且必须处于同一时区。
isCancelled Boolean 如果事件已取消,则设置为 true。
isDraft Boolean 如果用户在 Outlook 中更新了会议,但尚未将更新发送给与会者,则设置为 true。 如果所有更改均已发送,或者如果事件是不带任何与会者的约会,则设置为 false。
isOnlineMeeting Boolean 若此事件包含联机会议信息(即 onlineMeeting 指向 onlineMeetingInfo 资源)则为 True,反之则为 false。 默认值为 falseonlineMeetingnull)。 可选。
isOnlineMeeting 设置为 true 后,Microsoft Graph 将初始化 onlineMeeting。 随后,Outlook 将忽略对 isOnlineMeeting 的任何进一步更改,并且会议仍保持联机。
isOrganizer Boolean 如果日历所有者(通过“日历”的“所有者”属性指定)是事件的组织者(通过“事件”的“组织者”属性指定),设定为 true。 这也适用于代理人代表所有者组织事件。
isReminderOn Boolean 如果设置警报以提醒用户有事件,则设置为 true。
lastModifiedDateTime DateTimeOffset 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
位置 位置 事件的位置。
位置 location 集合 举办或参加活动的地点。 locationlocations 属性总是相互对应。 如果更新 location 属性,locations 集合中所有以前的位置都将被删除并替换为新的 location 值。
onlineMeeting OnlineMeetingInfo 关于与会者如何加入联机会议的详细信息。 默认值为 Null。 只读。
设置 isOnlineMeetingonlineMeetingProvider 属性以启用联机会议后,Microsoft Graph 将初始化 onlineMeeting。 设置后,会议仍保持联机,并且不能再次更改 isOnlineMeetingonlineMeetingProvideronlneMeeting 属性。
onlineMeetingProvider onlineMeetingProviderType 表示联机会议服务提供商。 默认情况下,onlineMeetingProviderunknown。 可取值为:unknownteamsForBusinessskypeForBusinessskypeForConsumer。 可选。
设置 isOnlineMeeting 后,Microsoft Graph 将初始化 onlineMeeting。 随后,你不能再次更改 onlineMeetingProvider,并且会议仍保持联机。
onlineMeetingUrl String 联机会议的 URL。 仅当组织者在 Outlook 中将事件指定为联机会议(如 Skype)才会设置此属性。 只读。
若要访问 URL 参加联机会议,请使用通过 eventonlineMeeting 属性公开的 joinUrl。 未来即将弃用 onlineMeetingUrl 属性。
组织者 收件人 事件的组织者。
originalEndTimeZone String 创建事件时设置的结束时区。 tzone://Microsoft/Custom 值表示旧的自定义时区已在桌面版 Outlook 中设置。
originalStart DateTimeOffset 表示最初创建为定期系列中的事件或异常的开始时间。 对于单个实例的事件,不返回此属性。 其日期和时间信息以 ISO 8601 格式表示,并且始终采用 UTC。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
originalStartTimeZone String 创建事件时设置的开始时区。 值表示旧的自定义时区在桌面版 Outlook 中设置。
recurrence PatternedRecurrence 事件的定期模式。
reminderMinutesBeforeStart Int32 事件开始时间(即提醒警报发生时间)之前的分钟数。
responseRequested 布尔值 默认值为 true,表示组织者愿意被邀请者发送事件响应。
responseStatus ResponseStatus 指示在事件消息的响应中发送的响应类型。
sensitivity String 可能的值是:normalpersonalprivateconfidential
seriesMasterId String 定期系列主项的 ID(如果此事件是定期系列的一部分)。
showAs String 要显示的状态。 可取值为:freetentativebusyoofworkingElsewhereunknown
start DateTimeTimeZone 事件的开始日期、时间和时区。 默认情况下,开始时间使用 UTC 格式。
subject String 事件的主题行文本。
transactionId 字符串 客户端应用为服务器指定的自定义标识符,用于避免因客户端重试创建相同事件而导致冗余的 POST 操作。 当低网络连接性导致客户端在从服务器中收到客户端先前创建事件请求的响应之前超时时,此功能很有用。 你在创建事件时设置 transactionId,之后不能在后续更新中更改 transactionId。 如果应用已设置此属性,则仅在响应有效负载中返回此属性。 可选。
type String 事件类型。 可取值为:singleInstanceoccurrenceexceptionseriesMaster。 只读
webLink String 要在 Web 上的 Outlook 中打开事件的 URL。

如果登录邮件,则 Outlook 网页面会在浏览器中打开事件。 否则,Outlook 网页面会提示你进行登录。

无法从 iFrame 中访问此 URL。

注意

webLink 属性指定了一个 URL,它仅在 Outlook 网页版早期版本中打开事件。 其 URL 的格式如下所示,其中 {event-id}id 属性的 URL 编码值:

  • 对于工作或学校帐户:https://outlook.office365.com/owa/?itemid={event-id}&exvsurl=1&path=/calendar/item

  • 对于 Microsoft 帐户:https://outlook.live.com/owa/?itemid={event-id}&exvsurl=1&path=/calendar/item

要在 Outlook 网页版的当前版本中打开事件,请将 URL 转换为下述格式之一,并使用该 URL 打开事件:

  • 对于工作或学校帐户:https://outlook.office365.com/calendar/item/{event-id}

  • 对于 Microsoft 帐户:https://outlook.live.com/calendar/item/{event-id}

关系

关系 类型 说明
attachments Attachment 集合 事件的 FileAttachmentItemAttachmentreferenceAttachment 附件的集合。 导航属性。 只读。 可为 Null。
日历 Calendar 包含事件的日历。 导航属性。 只读。
extensions 扩展集合 为事件定义的开放扩展集合。 可为空。
实例 Event 集合 定期系列的出现次数(如果该事件是系列母版事件)。 此属性包括定期模式的组成事件和已修改的例外,但不包括已从系列中取消的事件。 导航属性。 只读。 可为 Null。
multiValueExtendedProperties multiValueLegacyExtendedProperty 集合 为事件定义的多值扩展属性的集合。 只读。 可为 Null。
singleValueExtendedProperties singleValueLegacyExtendedProperty collection 为事件定义的单值扩展属性的集合。 只读。 可为 Null。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "allowNewTimeProposals": "Boolean",
  "attendees": [{"@odata.type": "microsoft.graph.attendee"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "categories": ["string"],
  "changeKey": "string",
  "createdDateTime": "String (timestamp)",
  "end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "hasAttachments": true,
  "hideAttendees": false,
  "id": "string (identifier)",
  "importance": "String",
  "isAllDay": true,
  "isCancelled": true,
  "isDraft": false,
  "isOnlineMeeting": true,
  "isOrganizer": true,
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "location": {"@odata.type": "microsoft.graph.location"},
  "locations": [{"@odata.type": "microsoft.graph.location"}],
  "onlineMeeting": {"@odata.type": "microsoft.graph.onlineMeetingInfo"},
  "onlineMeetingProvider": "string",
  "onlineMeetingUrl": "string",
  "organizer": {"@odata.type": "microsoft.graph.recipient"},
  "originalEndTimeZone": "string",
  "originalStart": "String (timestamp)",
  "originalStartTimeZone": "string",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "reminderMinutesBeforeStart": 1024,
  "responseRequested": true,
  "responseStatus": {"@odata.type": "microsoft.graph.responseStatus"},
  "sensitivity": "String",
  "seriesMasterId": "string",
  "showAs": "String",
  "start": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "string",
  "type": "String",
  "webLink": "string",

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