访问用户语言区域和时区

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

插件可以访问其用户的语言区域和时区,并使用该信息自定义其界面和行为。您必须配置插件的清单,以允许插件访问此信息。

配置插件清单

您可以按照以下步骤将插件配置为访问用户语言区域和时区信息:

  1. 在插件的清单文件中,将 addOns.common.useLocaleFromApp 字段设置为 true
  2. 如果尚未列出,请在清单的 oauthScopes 列表中添加以下显式范围: https://www.googleapis.com/auth/script.locale
  3. 保存清单更改。

如果您为插件的 oauthScope 列表添加了范围,用户必须在下次打开该插件时重新授权

获取语言区域和时区信息

如果配置正确,事件对象会携带用户语言区域信息。事件对象的 commonEventObject 子结构中显示以下字段:

  • commonEventObject.userLocale - 用户的语言和国家/地区标识符。例如 en-US
  • commonEventObject.timeZone.offset - 用户相对于世界协调时间 (UTC) 的时区偏移量(以毫秒为单位)。
  • commonEventObject.timeZone.id - 用户的时区标识符。 例如 America/New_York
  • commonEventObject.timeZone - 用户的时区 ID 和偏移量。

如需了解详情,请参阅事件对象

事件对象会在用户与插件互动时传递给操作回调函数,还会传递到首页和上下文触发函数。每个回调函数或触发器函数都可以从事件对象中读取语言区域和时区信息,并根据需要使用。例如,导航到新卡片的回调函数在决定向卡片添加什么文本时可以引用语言区域字符串。