Events: 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 (含首尾)。
maxAttendees	integer	要納入回應的參與者人數上限。如果參與者人數超過指定數量，系統只會傳回參與者。(選用)
sendNotifications	boolean	已淘汰，請改用 sendUpdates。 是否要傳送活動更新的通知 (例如說明變更等)。請注意，即使您將值設為 false，系統仍可能會傳送部分電子郵件。預設值為 false。
sendUpdates	string	邀請對象會收到活動更新的通知 (例如標題異動等)。 可接受的值如下： 「all」：所有邀請對像都會收到通知。 「externalOnly」：僅向非 Google 日曆邀請對象傳送通知。 「none」：未傳送通知。如要遷移日曆工作，請考慮改用 Events.import 方法。
supportsAttachments	boolean	執行作業的 API 用戶端是否支援事件附件。選用：預設值為 False。

授權

此要求需要至少具備下列其中一個範圍的授權：

範圍
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events

詳情請參閱驗證和授權頁面。

要求主體

在要求主體中，根據修補程式語意的規則提供事件資源的相關部分。

回應

如果成功，此方法會在回應主體中傳回 Events 資源。

試試看！

使用 APIs Explorer 針對即時資料呼叫這個方法，並查看回應。