Settings

設定資源代表使用者在日曆 UI 中可以變更的設定,例如使用者的時區。您可以透過 listget 方法擷取這些物件。請注意,如果設定中有預設值,就可能不會傳回該設定。

以下是支援的設定清單:

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