Settings

设置资源代表用户可以通过日历界面更改的设置，例如用户的时区。您可以通过 list 和 get 方法检索这些数据。请注意，如果某个设置采用默认值，则可能不会返回。

支持的设置列表：

设置 ID 说明 允许使用的值 默认值
autoAddHangouts 是否自动向所有活动添加视频会议（Meet 或插件）。请注意，如果 meetingDataVersion 大于 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 “Etc/GMT”
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。它始终必须是长度不超过 1024 个字符的 UTF-8 字符串。

方法

get
返回单个用户设置。
list
返回经过身份验证的用户的所有用户设置。
手表
留意“设置”资源的更改。