Calendars: patch
更新日曆的中繼資料。這個方法支援 patch 語意。請注意,每個修補要求都會耗用三個配額單位;偏好使用 get
,後面加上 update
。您指定的欄位值會取代現有的值。未指定要求中的欄位會維持不變。陣列欄位 (如有指定) 會覆寫現有陣列;就會捨棄先前的所有陣列元素。
立即試用。
要求
HTTP 要求
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId
參數
參數名稱 |
值 |
說明 |
路徑參數 |
calendarId |
string |
日曆 ID。如要擷取日曆 ID,請呼叫 calendarList.list 方法。如要存取目前登入使用者的主要日曆,請使用「primary 」字詞。
|
授權
此要求需要具有下列範圍的授權:
範圍 |
https://www.googleapis.com/auth/calendar |
詳情請參閱「驗證與授權」網頁。
要求主體
在要求主體中,請根據 patch 語意的規則,提供行事曆資源的相關部分。
回應
成功的話,這個方法會在回應主體中傳回行事曆資源。
試試看!
使用下方的 APIs Explorer,針對即時資料呼叫這個方法,看看會有什麼結果。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-08 (世界標準時間)。
[null,null,["上次更新時間:2024-09-08 (世界標準時間)。"],[[["Updates calendar metadata using patch semantics, replacing specified fields while leaving others unchanged."],["Requires authorization with the `https://www.googleapis.com/auth/calendar` scope."],["Uses a PATCH request to the specified calendar ID, which can be the primary calendar or retrieved using `calendarList.list`."],["Array fields, when updated, are entirely overwritten, discarding previous elements."],["Patch requests consume significant quota; using `get` and `update` together is more efficient for most changes."]]],[]]