Settings

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

支持的设置列表：

设置 ID	说明	允许使用的值	默认值
自动添加环聊	是否自动为所有活动添加环聊。请注意，如果 meetingDataVersion 大于 0，则服务器会忽略此设置，因为由客户端负责根据此设置处理逻辑。只读。	“true”或“false”	“false”
dateFieldOrder	显示日期时，以天 (D)、月 (M) 和年 (Y) 的顺序排列。	“MDY”、“DMY”、“YMD”	“MDY”
defaultEventLength	创建的活动的默认时长（以分钟为单位），没有明确时长。	正数	“60”
format24 小时时间	是否以 24 小时制显示时间。	“true”或“false”	“false”
隐藏邀请	是否隐藏用户受邀但尚未对事件执行操作（例如通过回复）的事件。	“true”或“false”	“false”
隐藏周末	显示一周时是否应隐藏周末。	“true”或“false”	“false”
语言区域	用户的语言区域。	。	“en”
仅 rememberOnReplyedEventsOnly	是否应仅针对用户的回复状态为“是”和“不确定”的事件发送事件提醒。	“true”或“false”	“false”
showRejecteddEvents	是否应在用户日历中显示用户回复“否”的活动。	“true”或“false”	“true”
时区	用户所在时区的 ID。	请参阅 http://www.iana.org/time-zones	“其他/GMT”
使用键盘快捷键	是否启用键盘快捷键。	“true”或“false”	“true”
开始周	星期几是星期日 (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 个字符。

方法

get

返回单个用户设置。

list

返回已通过身份验证的用户的所有用户设置。

手表

留意“设置”资源的变化。