Надстройки Google Workspace могут получать доступ к локали и часовому поясу своего пользователя и использовать эту информацию для настройки своего интерфейса и поведения. Вам необходимо настроить манифест надстройки, чтобы разрешить ей доступ к этой информации.
Настройте манифест дополнения
Вы можете настроить надстройку для доступа к информации о местоположении и часовом поясе пользователя, выполнив следующие действия:
- В файле манифеста вашего дополнения установите для поля
addOns.common.useLocaleFromAppзначениеtrue. - Если его еще нет, добавьте следующую явную область действия в список
oauthScopesманифеста:https://www.googleapis.com/auth/script.locale
Если вы добавили область действия в список oauthScope надстройки, пользователям придется повторно авторизовать надстройку при следующем ее открытии.
Получить информацию о местоположении и часовом поясе
Объекты событий несут информацию о локали пользователя при правильной настройке. В подструктуре commonEventObject объекта события появляются следующие поля:
-
commonEventObject.userLocale—Идентификатор языка и страны/региона пользователя. Например,en-US. -
commonEventObject.timeZone.offset— смещение часового пояса пользователя в миллисекундах от всемирного координированного времени (UTC). -
commonEventObject.timeZone.id— идентификатор часового пояса пользователя. Например,America/New_York. -
commonEventObject.timeZone— идентификатор часового пояса пользователя и смещение.
Более подробную информацию см. в разделе Объекты событий .
Объекты событий передаются в функции обратного вызова действий , когда пользователь взаимодействует с вашим дополнением, а также в функции домашней страницы и контекстного триггера. Каждая функция обратного вызова или триггера может считывать информацию о локали и часовом поясе из объекта события и использовать ее по мере необходимости. Например, функция обратного вызова, которая осуществляет навигацию к новой карточке, может ссылаться на строку локали при принятии решения о том, какой текст добавить к карточке.