获取用户语言区域和时区

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

配置插件清单

您可以配置自己的插件以访问用户语言区域和 时区信息 具体步骤如下：

  1. 在插件的清单中 文件，设置 addOns.common.useLocaleFromApp 字段设置为 true。
  2. 如果不存在，请将以下显式作用域添加到 清单的oauthScopes 列表： https://www.googleapis.com/auth/script.locale

如果您之前向该插件的 oauthScope 列表添加了范围， 用户必须重新授权 插件 再次打开该文件夹

获取语言区域和时区信息

事件对象 在正确配置的情况下包含用户语言区域信息。以下字段 出现在commonEventObject中 事件对象的子结构：

  • commonEventObject.userLocale - 用户的语言和国家/地区 标识符。例如 en-US。
  • commonEventObject.timeZone.offset - 用户的时区偏移量，以 毫秒。
  • commonEventObject.timeZone.id - 用户的时区标识符。 例如 America/New_York。
  • commonEventObject.timeZone - 用户的时区 ID 和偏移量。

请参阅事件对象 了解详情。

事件对象会传递到 操作回调函数 当用户与您的插件互动时触发 和情境 触发函数。每个回调函数或触发器函数都可以读取 事件对象中的语言区域和时区信息，并根据需要使用。 例如， 导航到新卡片 在决定向卡片中添加哪些文字时，可以参考语言区域字符串。