更新事件

更新事件对象的属性。

先决条件

要执行此 API,需要以下范围之一:Calendars.ReadWrite

HTTP 请求

PATCH /me/events/{id}
PATCH /users/{id | userPrincipalName}/events/{id}
PATCH /groups/{id}/events/{id}

PATCH /me/calendar/events/{id}
PATCH /users/{id | userPrincipalName}/calendar/events/{id}
PATCH /groups/{id}/calendar/events/{id}

PATCH /me/calendars/{id}/events/{id}
PATCH /users/{id | userPrincipalName}/calendars/{id}/events/{id}

PATCH /me/calendargroup/calendars/{id}/events/{id}
PATCH /users/{id | userPrincipalName}/calendargroup/calendars/{id}/events/{id}

PATCH /me/calendargroups/{id}/calendars/{id}/events/{id}
PATCH /users/{id | userPrincipalName}/calendargroups/{id}/calendars/{id}/events/{id}

请求标头

名称 类型 说明
Authorization string Bearer . Required.

请求正文

在请求正文中,提供应更新的相关字段的值。请求正文中不包括的现有属性将保留其以前的值,或根据对其他属性值的更改重新计算。为了获得最佳性能,不应包括尚未更改的现有值。

属性 类型 说明
attendees 与会者 事件的与会者集合。
body ItemBody 与事件相关联的邮件正文。
categories String 与事件相关联的类别。
end DateTimeTimeZone 事件的结束日期和时间。

默认情况下,结束时间使用 UTC 格式。可以在 EndTimeZone 中指定可选的时区,用该时区表示结束时间并包括与 UTC 的时间偏移量。请注意,如果使用 EndTimeZone,必须为 StartTimeZone 指定一个值。

本示例指定太平洋标准时间的 2015 年 2 月 25 日晚上 9:34:“2015-02-25T21:34:00-08:00”。
重要性 String 事件的重要性:低 = 0、普通 = 1、高 = 2。可能的值是:LowNormalHigh
isAllDay Boolean 如果事件持续一整天,则设置为 true。
isReminderOn Boolean 如果设置警报以提醒用户有事件,则设置为 true。
位置 位置 事件的位置。
onlineMeetingUrl String 在线会议的链接。
recurrence PatternedRecurrence 事件的定期模式。
reminderMinutesBeforeStart Int32 事件开始时间(即提醒警报发生时间)之前的分钟数。
responseRequested Boolean 如果发件人希望接收事件被接受或拒绝时的响应,则设置为 true。
sensitivity String 可能的值是:NormalPersonalPrivateConfidential
showAs String 要显示的状态:空闲 = 0、暂定 = 1、忙碌 = 2、Oof = 3、WorkingElsewhere = 4、未知 =-1。可能的值是:FreeTentativeBusyOofWorkingElsewhereUnknown
start DateTimeTimeZone 事件的开始时间。

默认情况下,开始时间使用 UTC 格式。可以在 StartTimeZone 中指定可选的时区,用该时区表示开始时间并包括与 UTC 的时间偏移量。请注意,如果使用 StartTimeZone,你也必须为 EndTimeZone 指定一个值。

本示例指定太平洋标准时间的 2015 年 2 月 25 日晚上 7:34:“2015-02-25T19:34:00-08:00”。
subject String 事件的主题行文本。

由于事件资源支持扩展,因此可以使用 PATCH 操作在现有事件实例的扩展自定义属性中添加、更新或删除自己的特定于应用的数据。

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和更新的 event 对象。

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/v1.0/me/events/{id}
Content-type: application/json
Content-length: 285

{
  "originalStartTimeZone": "originalStartTimeZone-value",
  "originalEndTimeZone": "originalEndTimeZone-value",
  "responseStatus": {
    "response": "",
    "time": "datetime-value"
  },
  "iCalUId": "iCalUId-value",
  "reminderMinutesBeforeStart": 99,
  "isReminderOn": true
}
响应

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 285

{
  "originalStartTimeZone": "originalStartTimeZone-value",
  "originalEndTimeZone": "originalEndTimeZone-value",
  "responseStatus": {
    "response": "",
    "time": "datetime-value"
  },
  "iCalUId": "iCalUId-value",
  "reminderMinutesBeforeStart": 99,
  "isReminderOn": true
}

另请参阅