更新活動。這個方法支援 patch 語意。請注意，每個修補程式要求會耗用三個配額單位，建議使用 get，然後再使用 update。您指定的欄位值會取代現有值。要求中未指定的欄位會維持不變。如果指定陣列欄位，系統會覆寫現有陣列，並捨棄先前的所有陣列元素。
立即試用。
要求
HTTP 要求
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
參數
| 參數名稱 | 值 | 說明 |
|---|---|---|
| 路徑參數 | ||
calendarId |
string |
日曆 ID。如要擷取日曆 ID，請呼叫 calendarList.list 方法。如要存取目前登入使用者的主要日曆，請使用「primary」關鍵字。
|
eventId |
string |
事件 ID。 |
| 選用查詢參數 | ||
alwaysIncludeEmail |
boolean |
已淘汰並忽略。即使沒有可用的實際電子郵件地址 (也就是系統會提供產生的無效值)，系統仍會在主辦人、建立者和出席者的 email 欄位中傳回值。
|
conferenceDataVersion |
integer |
API 用戶端支援的會議資料版本號碼。版本 0 假設不支援會議資料，並忽略活動主體中的會議資料。第 1 版支援複製 ConferenceData，以及使用 conferenceData 的 createRequest 欄位建立新會議。預設值為 0。
可接受介於 0 到 1 (包含這兩者) 之間的值。
|
eventLabelVersion |
integer |
API 用戶端支援的事件標籤功能版本號碼。版本 0 假設不支援事件標籤，並處理 colorId 欄位以進行色彩管理。版本 1 支援事件標籤，並處理事件主體中的 eventLabelId。在這種情況下，系統會忽略 colorId 欄位。預設值為 0。
可接受介於 0 到 1 (包含這兩者) 之間的值。
|
maxAttendees |
integer |
回覆中可納入的出席者人數上限。如果出席者人數超過指定人數，系統只會傳回參與者。選用。 |
sendNotifications |
boolean |
已淘汰，請改用 sendUpdates。 是否要傳送活動更新通知 (例如說明變更等)。請注意，即使將值設為 false，系統仍可能會傳送部分電子郵件。預設值為 false。
|
sendUpdates |
string |
應接收活動更新通知的邀請對象 (例如標題變更等)。
可接受的值如下：
|
supportsAttachments |
boolean |
執行作業的 API 用戶端是否支援事件附件。(選用步驟) 預設值為 False。 |
授權
這項要求需要至少下列其中一個範圍的授權：
| 範圍 |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.events.owned |
詳情請參閱「驗證和授權」頁面。
要求主體
在要求主體中，根據修補程式語意規則，提供 Events 資源的相關部分。
回應
如果成功的話，這個方法會在回應內文中傳回 Events 資源。
試試看！
您可以使用下方的 API Explorer，針對即時資料呼叫這個方法，然後查看回應。