Settings

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

支援設定清單：

設定 ID	說明	接受的值	預設值
自動新增 Hangouts	是否自動將 Hangouts 新增到所有活動。請注意，如果 conferenceDataVersion 大於 0，則伺服器會忽略這項設定，因為用戶端必須根據這項設定處理邏輯。(唯讀)。	「true」、「false」	「false」
日期欄位順序	顯示日期時，日期 (D)、月 (M) 和年份 (Y) 的順序應該一致。	「MDY」、「DMY」、「YMD」	「MDY」
預設事件長度	建立時沒有明確時間長度的預設事件時間長度 (以分鐘為單位)。	正數	「60」
格式 24 小時	是否以 24 小時格式顯示時間。	「true」、「false」	「false」
隱藏邀請	是否隱藏使用者受邀但未採取行動 (例如回覆) 的活動。	「true」、「false」	「false」
隱藏週末	是否顯示週末時應隱藏週末。	「true」、「false」	「false」
語言代碼	使用者所在地區。	「{0/}」代表	「en」
僅限提醒開啟回應事件	是否只應回覆使用者的回覆狀態為「是」和「不確定」的活動。	「true」、「false」	「false」
顯示拒絕活動	是否要在使用者的日曆中顯示 [回覆] 回覆使用者的活動。	「true」、「false」	「true」
時區	使用者時區的 ID。	請參閱 http://www.iana.org/time-zones	「Etc/GMT」
使用鍵盤快速鍵	是否要啟用鍵盤快速鍵。	「true」、「false」	「true」
weekStart	一週是否為星期日 (0)、星期一 (1) 或星期六 (6)。	「0」、「1」、「6」	「0」

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

資源表示法

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

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

方法

取得

傳回單一使用者設定。

list

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

觀看

請留意「設定」資源的異動。