更新使用者日曆清單中的現有日曆。這個方法支援 patch 語意。請注意，每個修補要求都會消耗三個配額單位；建議使用 get 後接 update。您指定的欄位值會取代現有值。您在要求中未指定的欄位會維持不變。如果指定陣列欄位，系統會覆寫現有的陣列，並捨棄任何先前的陣列元素。立即試用。
要求
HTTP 要求
PATCH https://www.googleapis.com/calendar/v3/users/me/calendarList/calendarId
參數
| 參數名稱 | 值 | 說明 |
|---|---|---|
| 路徑參數 | ||
calendarId |
string |
日曆 ID。如要擷取日曆 ID，請呼叫 calendarList.list 方法。如果您想存取目前登入使用者的主日曆，請使用「primary」關鍵字。
|
| 選用查詢參數 | ||
colorRgbFormat |
boolean |
是否要使用 foregroundColor 和 backgroundColor 欄位寫入日曆顏色 (RGB)。如果使用這項功能，系統會自動將以索引為準的 colorId 欄位設為最相符的選項。選用設定。預設值為 False。
|
授權
這項要求需要至少具備下列其中一個範圍的授權：
| 範圍 |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.calendarlist |
詳情請參閱「驗證與授權」頁面。
要求主體
在要求內容中，根據修補語義規則提供 CalendarList 資源的相關部分。
回應
如果成功，這個方法會在回應內文中傳回 CalendarList 資源。
試試看！
您可以使用下方的 API Explorer，針對即時資料呼叫這個方法，然後查看回應。