本頁面由 Cloud Translation API 翻譯而成。

Settings

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

支援的設定清單如下：

設定 ID	說明	接受的值	預設值
autoAddHangouts	是否自動將 Hangouts 新增至所有活動。請注意，如果 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"、	“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: 傳回已驗證使用者的所有使用者設定。
手錶: 留意設定資源的異動。