Settings

设置资源表示用户可以通过日历界面更改的设置,例如用户的时区。您可以通过 listget 方法检索这些键。请注意,如果某项设置有默认值,可能不会返回。

受支持的设置列表如下:

设置 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 个字符。

方法

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