事件资源类型

日历中的事件。

该资源支持:

  • 使用扩展将自己的数据添加到自定义属性。
  • 通过提供 delta 函数使用增量查询跟踪增量添加、删除和更新。

方法

方法 返回类型 说明
列出事件 事件 集合 检索用户邮箱中的 event 对象列表。该列表包含单个实例会议和系列主控形状。
创建事件 事件 通过发布到实例集合创建新事件。
获取事件 事件 读取 event 对象的属性和关系。
更新 事件 更新事件对象。
删除 删除事件对象。
接受 接受指定的事件。
tentativelyAccept 暂时接受指定的事件。
拒绝 拒绝对指定事件的邀请。
delta 事件集合 获取用户主日历的 calendarView(事件范围)中已添加、删除或更新的事件集。
dismissReminder 消除指定事件的提醒。
snoozeReminder 暂停指定事件的提醒。
列出实例 事件 集合 获取指定的时间范围的事件的实例(发生次数)。如果事件的类型是 SeriesMaster,这将返回在指定的时间范围内事件的发生次数和异常。
附件
列出附件 attachment 集合 获取事件的所有附件。
Add attachment attachment 通过发布到附件集合,向事件添加新附件。
开放扩展
创建开放扩展 openTypeExtension 创建开放扩展,并在新建或现有的资源实例中添加自定义属性。
获取开放扩展 openTypeExtension 集合 获取通过名称或完全限定的名称识别的一个或多个开放扩展对象。
扩展属性
创建单值扩展属性 事件 在新建或现有事件中创建一个或多个单值扩展属性。
获取具有单值扩展属性的事件 事件 通过使用 $expand$filter 获取包含单值扩展属性的事件。
创建多值扩展属性 事件 在新建或现有的事件中创建一个或多个多值扩展属性。
获取具有多值扩展属性的事件 事件 使用 $expand 获取包含一个多值扩展属性的事件。

属性

属性 类型 说明
attendees 与会者 集合 事件的与会者集合。
body itemBody 与事件相关联的邮件正文。可以是 HTML 格式或文本格式。
bodyPreview 字符串 与事件相关联的邮件预览。文本格式。
categories String collection 与事件相关联的类别。
changeKey String 标识 event 对象的版本。每次事件更改时,ChangeKey 也将更改。这样,Exchange 可以将更改应用于该对象的正确版本。
createdDateTime DateTimeOffset 时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 如下所示:'2014-01-01T00:00:00Z'
end dateTimeTimeZone 事件结束的日期、时间和时区。
hasAttachments Boolean 如果事件包含附件,则设置为 true。
iCalUId String 由不同日历间的所有事件实例共享的唯一标识符。
id String 只读。
importance String 事件的重要性:低 = 0、普通 = 1、高 = 2。可能的值是:LowNormalHigh
isAllDay Boolean 如果事件持续一整天,则设置为 true。
isCancelled Boolean 如果事件已取消,则设置为 true。
isOrganizer Boolean 如果邮件发件人也是组织者,则设置为 true。
isReminderOn Boolean 如果设置警报以提醒用户有事件,则设置为 true。
lastModifiedDateTime DateTimeOffset 时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 如下所示:'2014-01-01T00:00:00Z'
location 位置 事件的位置。
onlineMeetingUrl String 在线会议的 URL。
organizer recipient 事件的组织者。
originalEndTimeZone 字符串 创建事件时设置的结束时区。tzone://Microsoft/Custom 值表示旧的自定义时区在桌面版 Outlook 中设置。
originalStart DateTimeOffset 时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 如下所示:'2014-01-01T00:00:00Z'
originalStartTimeZone 字符串 创建事件时设置的开始时区。tzone://Microsoft/Custom 值表示旧的自定义时区在桌面版 Outlook 中设置。
recurrence patternedRecurrence 事件的定期模式。
reminderMinutesBeforeStart Int32 事件开始时间(即提醒警报发生时间)之前的分钟数。
responseRequested Boolean 如果发件人希望接收事件被接受或拒绝时的响应,则设置为 true。
responseStatus responseStatus 指示在事件消息的响应中发送的响应类型。
sensitivity String 可能的值是:NormalPersonalPrivateConfidential
seriesMasterId String 分配给项目的类别。
showAs String 要显示的状态。 可取值为 FreeTentativeBusyOofWorkingElsewhereUnknown
start dateTimeTimeZone 事件开始的日期、时间和时区。
subject String 事件的主题行文本。
type String 事件类型。 可取值为 SingleInstanceOccurrenceExceptionSeriesMaster。 只读。
webLink String 要在 Outlook Web App 中打开事件的 URL。

如果你通过 Outlook Web App 登录邮箱,该事件将在浏览器中打开。如果尚未使用浏览器登录,系统将提示你登录。

可以从 iFrame 中访问此 URL。

关系

关系 类型 说明
attachments 附件 集合 事件的 fileAttachmentitemAttachment 附件集合。导航属性。只读。可为 Null。
日历 日历 包含事件的日历。导航属性。只读。
extensions 扩展集合 为事件定义的开放扩展集合。只读。可为 Null。
instances 事件 集合 事件的实例。导航属性。只读。可为 Null。
multiValueExtendedProperties multiValueLegacyExtendedProperty 集合 为事件定义的多值扩展属性的集合。只读。可为 Null。
singleValueExtendedProperties singleValueLegacyExtendedProperty collection 为事件定义的单值扩展属性的集合。只读。可为 Null。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "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,
  "iCalUId": "string",
  "id": "string (identifier)",
  "importance": "String",
  "isAllDay": true,
  "isCancelled": true,
  "isOrganizer": true,
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "location": {"@odata.type": "microsoft.graph.location"},
  "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" }],
  "multiValueExtendedProperties": [ { "@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty" }],
  "singleValueExtendedProperties": [ { "@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty" }]

}

另请参阅