Надстройки могут получать доступ к локали и часовому поясу своего пользователя и использовать эту информацию для настройки своего интерфейса и поведения. Вы должны настроить манифест своей надстройки, чтобы разрешить ей доступ к этой информации.
Настройте манифест дополнения
Вы можете настроить надстройку для доступа к информации о локали и часовом поясе пользователя, выполнив следующие действия:
- В файле манифеста вашей надстройки установите для поля
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— Идентификатор и смещение часового пояса пользователя.
Дополнительные сведения см. в разделе Объекты событий .
Объекты событий передаются функциям обратного вызова действий , когда пользователь взаимодействует с вашим дополнением, а также функциям домашней страницы и контекстным триггерам. Каждая функция обратного вызова или триггера может считывать информацию о локали и часовом поясе из объекта события и использовать ее по мере необходимости. Например, функция обратного вызова, осуществляющая переход к новой карточке, может ссылаться на строку языкового стандарта при принятии решения о том, какой текст добавить на карточку.