设置资源表示用户可以通过日历界面更改的设置,例如用户的时区。您可以通过 list 和 get 方法检索这些键。请注意,如果某项设置有默认值,可能不会返回。
受支持的设置列表如下:
设置 ID | 说明 | 允许使用的值 | 默认价值 |
---|---|---|---|
autoAddHangouts | 是否自动将 Hangouts 添加到所有活动中。请注意,如果 sessionDataVersion 大于 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", " ", _ ", ", ", ", ", ", " | “en” |
remindOnRespondedEventsOnly | 是否应仅为用户回复状态为“是”和“不确定”的活动发送活动提醒。 | “true”“false” | “false” |
showDeclinedEvents | 是否应在用户的日历中显示用户回复“否”的活动。 | “true”“false” | “true” |
timezone | 用户所在时区的 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 个字符。 |