事件资源类型event resource type

日历中的事件。An event in a calendar.

该资源支持:This resource supports:

方法Methods

方法Method 返回类型Return Type 说明Description
列出事件List events 事件 集合event collection 检索用户邮箱中的 event 对象列表。该列表包含单个实例会议和系列主控形状。Retrieve a list of event objects in the user's mailbox. The list contains single instance meetings and series masters.
创建事件Create event 事件event 通过发布到实例集合创建新事件。Create a new event by posting to the instances collection.
获取事件Get event 事件event 读取 event 对象的属性和关系。Read properties and relationships of event object.
更新Update 事件event 更新事件对象。Update event object.
删除Delete None 删除事件对象。Delete event object.
接受accept None 接受指定的事件。Accept the specified event.
tentativelyAccepttentativelyAccept None 暂时接受指定的事件。Tentatively accept the specified event.
拒绝decline None 拒绝对指定事件的邀请。Decline invitation to the specified event.
deltadelta 事件集合event collection 获取用户主日历的 calendarView(事件范围)中已添加、删除或更新的事件集。Get a set of events that have been added, deleted, or updated in a calendarView (a range of events) of the user's primary calendar.
dismissReminderdismissReminder None 消除指定事件的提醒。Dismiss the reminder for the specified event.
snoozeRemindersnoozeReminder None 暂停指定事件的提醒。Snooze the reminder for the specified event.
列出实例List instances 事件 集合event collection 获取指定的时间范围的事件的实例(发生次数)。如果事件的类型是 SeriesMaster,这将返回在指定的时间范围内事件的发生次数和异常。Get the instances (occurrences) of an event for a specified time range. If the event is a SeriesMaster type, this returns the occurrences and exceptions of the event in the specified time range.
附件Attachments
列出附件List attachments attachment 集合attachment collection 获取事件的所有附件。Get all attachments on an event.
Add attachmentAdd attachment attachmentattachment 通过发布到附件集合,向事件添加新附件。Add a new attachment to an event by posting to the attachments collection.
开放扩展Open extensions
创建开放扩展Create open extension openTypeExtensionopenTypeExtension 创建开放扩展,并在新建或现有的资源实例中添加自定义属性。Create an open extension and add custom properties in a new or existing instance of a resource.
获取开放扩展Get open extension openTypeExtension 集合openTypeExtension collection 获取通过名称或完全限定的名称识别的一个或多个开放扩展对象。Get an open extension object or objects identified by name or fully qualified name.
扩展属性Extended properties
创建单值扩展属性Create single-value extended property 事件event 在新建或现有事件中创建一个或多个单值扩展属性。Create one or more single-value extended properties in a new or existing event.
获取具有单值扩展属性的事件Get event with single-value extended property 事件event 通过使用 $expand$filter 获取包含单值扩展属性的事件。Get events that contain a single-value extended property by using $expand or $filter.
创建多值扩展属性Create multi-value extended property 事件event 在新建或现有的事件中创建一个或多个多值扩展属性。Create one or more multi-value extended properties in a new or existing event.
获取具有多值扩展属性的事件Get event with multi-value extended property 事件event 使用 $expand 获取包含一个多值扩展属性的事件。Get an event that contains a multi-value extended property by using $expand.

属性Properties

属性Property 类型Type 说明Description
attendeesattendees 与会者 集合attendee collection 事件的与会者集合。The collection of attendees for the event.
bodybody itemBodyitemBody 与事件相关联的邮件正文。可以是 HTML 格式或文本格式。The body of the message associated with the event. It can be in HTML or text format.
bodyPreviewbodyPreview 字符串String 与事件相关联的邮件预览。文本格式。The preview of the message associated with the event. It is in text format.
categoriescategories String collectionString collection 与事件相关联的类别。The categories associated with the event.
changeKeychangeKey StringString 标识 event 对象的版本。每次事件更改时,ChangeKey 也将更改。这样,Exchange 可以将更改应用于该对象的正确版本。Identifies the version of the event object. Every time the event is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset 时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 如下所示:'2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
endend dateTimeTimeZonedateTimeTimeZone 事件结束的日期、时间和时区。The date, time, and time zone that the event ends.
hasAttachmentshasAttachments BooleanBoolean 如果事件包含附件,则设置为 true。Set to true if the event has attachments.
iCalUIdiCalUId StringString 由不同日历间的所有事件实例共享的唯一标识符。A unique identifier that is shared by all instances of an event across different calendars. 只读。Read-only.
idid StringString 只读。Read-only.
importanceimportance importanceimportance 事件的重要性。The importance of the event. 可能的值为: lownormalhighThe possible values are: low, normal, high.
isAllDayisAllDay BooleanBoolean 如果事件持续一整天,则设置为 true。Set to true if the event lasts all day.
isCancelledisCancelled BooleanBoolean 如果事件已取消,则设置为 true。Set to true if the event has been canceled.
isOrganizerisOrganizer BooleanBoolean 如果邮件发件人也是组织者,则设置为 true。Set to true if the message sender is also the organizer.
isReminderOnisReminderOn BooleanBoolean 如果设置警报以提醒用户有事件,则设置为 true。Set to true if an alert is set to remind the user of the event.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset 时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 如下所示:'2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
locationlocation 位置location 事件的位置。The location of the event.
locationslocations location 集合location collection 举办或参加活动的地点。The locations where the event is held or attended from. locationlocations 属性总是相互对应。The location and locations properties always correspond with each other. 如果更新 location 属性,locations 集合中所有以前的位置都将被删除并替换为新的 location 值。If you update the location property, any prior locations in the locations collection would be removed and replaced by the new location value.
onlineMeetingUrlonlineMeetingUrl StringString 在线会议的 URL。A URL for an online meeting. 仅组织者指定为联机会议如 Skype 会议事件时,该属性是设置。The property is set only when an organizer specifies an event as an online meeting such as a Skype meeting. 只读。Read-only.
organizerorganizer recipientrecipient 事件的组织者。The organizer of the event.
originalEndTimeZoneoriginalEndTimeZone StringString 创建事件时设置的结束时区。The end time zone that was set when the event was created. tzone://Microsoft/Custom 值表示旧的自定义时区已在桌面版 Outlook 中设置。A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
originalStartoriginalStart DateTimeOffsetDateTimeOffset 时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 如下所示:'2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
originalStartTimeZoneoriginalStartTimeZone 字符串String 创建事件时设置的开始时区。tzone://Microsoft/Custom 值表示旧的自定义时区在桌面版 Outlook 中设置。The start time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
recurrencerecurrence patternedRecurrencepatternedRecurrence 事件的定期模式。The recurrence pattern for the event.
reminderMinutesBeforeStartreminderMinutesBeforeStart Int32Int32 事件开始时间(即提醒警报发生时间)之前的分钟数。The number of minutes before the event start time that the reminder alert occurs.
responseRequestedresponseRequested BooleanBoolean 如果发件人希望接收事件被接受或拒绝时的响应,则设置为 true。Set to true if the sender would like a response when the event is accepted or declined.
responseStatusresponseStatus responseStatusresponseStatus 指示在事件消息的响应中发送的响应类型。Indicates the type of response sent in response to an event message.
sensitivitysensitivity sensitivitysensitivity 可能的值为: normalpersonalprivateconfidentialThe possible values are: normal, personal, private, confidential.
seriesMasterIdseriesMasterId StringString 定期系列主项目,如果该事件是定期系列的一部分的 ID。The ID for the recurring series master item, if this event is part of a recurring series.
showAsshowAs freeBusyStatusfreeBusyStatus 要显示的状态。The status to show. 可能的值为: freetentativebusyoofworkingElsewhereunknownThe possible values are: free, tentative, busy, oof, workingElsewhere, unknown.
startstart dateTimeTimeZonedateTimeTimeZone 事件开始的日期、时间和时区。The date, time, and time zone that the event starts.
subjectsubject StringString 事件的主题行文本。The text of the event's subject line.
typetype eventTypeeventType 事件类型。The event type. 可能的值为: singleInstanceoccurrenceexceptionseriesMasterThe possible values are: singleInstance, occurrence, exception, seriesMaster. 只读。Read-only.
webLinkwebLink StringString 要在 Outlook Web App 中打开事件的 URL。The URL to open the event in Outlook Web App.

如果你通过 Outlook Web App 登录邮箱,该事件将在浏览器中打开。如果尚未使用浏览器登录,系统将提示你登录。The event will open in the browser if you are logged in to your mailbox via Outlook Web App. You will be prompted to login if you are not already logged in with the browser.

可以从 iFrame 中访问此 URL。This URL can be accessed from within an iFrame.

关系Relationships

关系Relationship 类型Type 说明Description
attachmentsattachments 附件 集合attachment collection 事件的 fileAttachmentitemAttachment 附件集合。导航属性。只读。可为 Null。The collection of fileAttachment and itemAttachment attachments for the event. Navigation property. Read-only. Nullable.
日历calendar 日历calendar 包含事件的日历。导航属性。只读。The calendar that contains the event. Navigation property. Read-only.
extensionsextensions 扩展集合Extension collection 为事件定义的开放扩展集合。只读。可为 Null。The collection of open extensions defined for the event. Read-only. Nullable.
instancesinstances 事件 集合event collection 事件的实例。导航属性。只读。可为 Null。The instances of the event. Navigation property. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty 集合multiValueLegacyExtendedProperty collection 为事件定义的多值扩展属性的集合。只读。可为 Null。The collection of multi-value extended properties defined for the event. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty collectionsingleValueLegacyExtendedProperty collection 为事件定义的单值扩展属性的集合。只读。可为 Null。The collection of single-value extended properties defined for the event. Read-only. Nullable.

JSON 表示形式JSON representation

下面是资源的 JSON 表示形式。Here is a JSON representation of the resource

{
  "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"},
  "locations": [{"@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" }]

}

另请参阅See also