Settings

設定資源代表使用者可在日曆 UI 中變更的設定，例如使用者的時區。您可以透過 list 和 get 方法擷取這些資料。請注意，如果設定有預設值，系統可能不會傳回該設定。

支援的設定清單如下：

設定 ID	說明	接受的值	預設值
autoAddHangouts	是否要自動將視訊會議 (Meet 或外掛程式) 新增至所有活動。請注意，如果 meetDataVersion 大於 0，伺服器就會忽略這項設定，因為用戶端會根據這項設定處理邏輯。僅供檢視。	“true”、”false”	「false」
dateFieldOrder	顯示日期時，應按日 (D)、月 (M) 和年 (Y) 的順序排列。	“MDY”、”DMY”、”YMD”	”MDY”
defaultEventLength	未明確指定持續時間時，事件的預設長度 (以分鐘為單位)。	正數	“60”
format24HourTime	是否以 24 小時制顯示時間。	“true”、”false”	「false」
hideInvitations	是否要隱藏使用者已受邀但尚未採取行動 (例如回覆) 的活動。	“true”、”false”	“false”
hideWeekends	是否要在顯示一週時隱藏週末。	“true”、”false”	「false」
語言代碼	使用者的語言代碼。	"in", "ca","cs", "da", "de", "en_GB", "en", "es", "es_419", "tl", "fr", "hr", "it", "lv", "lt", "hu", "nl", "no", "pl", "pt_BR", "pt_PT", "ro", "sk", "sl", "fi", "sv", "tr", "vi", "el", "ru", "sr", "uk", "bg", "iw", "ar", "fa", "hi", "th", "zh_TW", "zh_CN", "ja", "ko"	“en”
remindOnRespondedEventsOnly	是否應該只針對回應狀態為「是」或「不確定」的活動傳送活動提醒。	“true”、”false”	“false”
showDeclinedEvents	是否應在使用者日曆中顯示使用者回覆「否」的活動。	“true”、”false”	“true”
時區	使用者時區的 ID。	請參閱 http://www.iana.org/time-zones	「等新聞/格林威治標準時間」
useKeyboardShortcuts	是否啟用鍵盤快速鍵。	“true”、”false”	“true”
weekStart	一週的開始日是星期日 (0)、星期一 (1) 還是星期六 (6)。	「0」、「1」、「6」	「0」

如需本資源的方法清單，請見本頁結尾。

資源表示法

{
  "kind": "calendar#setting",
  "etag": etag,
  "id": string,
  "value": string
}

屬性名稱	值	說明	附註
etag	etag	資源的 ETag。
id	string	使用者設定的 ID。
kind	string	資源類型 (「calendar#setting」)。
value	string	使用者設定的值。值的格式取決於設定 ID。這個值一律為 UTF-8 字串，長度上限為 1024 個字元。

方法

取得

傳回單一使用者的設定。

list

傳回已驗證使用者的所有使用者設定。

手錶

留意設定資源的異動。