Settings

设置资源表示用户可通过日历界面更改的设置，例如用户的时区。您可以通过 list 和 get 方法检索这些事件。请注意，如果某项设置具有默认值，系统可能不会返回该默认值。

受支持的设置列表如下：

设置 ID	说明	允许使用的值	默认值
autoAddHangouts	是否自动向所有活动添加环聊。请注意，如果 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", " " "	“en”
remindOnRespondedEventsOnly	是否只应为用户回复状态为“是”和“不确定”的活动发送活动提醒。	“true”“false”	“false”
showDeclinedEvents	用户回复“否”的活动是否应在用户的日历上显示。	“true”“false”	“true”
时区	用户所在时区的 ID。	请参阅 http://www.iana.org/time-zones	“其他/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

返回已验证用户的所有用户设置。

手表

请注意“设置”资源的更改。