Получите языковой стандарт и часовой пояс для пользователя дополнения Google Workspace.

В этом руководстве объясняется, как надстройка может получить языковой стандарт и часовой пояс пользователя, а затем использовать эту информацию для настройки своего интерфейса и поведения. Руководство по использованию скрипта Google Apps см. в разделе Получение языкового стандарта и часового пояса пользователя в документации для разработчиков Apps Script.

Настройте ресурс развертывания надстройки.

Чтобы разрешить надстройке получать языковой стандарт и часовой пояс пользователя, настройте ресурс развертывания надстройки:

1. В ресурсе развертывания надстройки установите для поля addOns.common.useLocaleFromApp true .
2. Добавьте область авторизации https://www.googleapis.com/auth/script.locale в список oauthScopes ресурса развертывания. Эта область предоставляет надстройке разрешение пользователя на просмотр его страны, языка и часового пояса.
3. Сохраните обновленный ресурс развертывания.

После добавления области в список oauthScopes надстройки пользователи должны повторно авторизовать надстройку при следующем ее использовании.

Получить информацию о локали и часовом поясе

Объекты событий включают информацию о локали пользователя, которую можно получить из следующих свойств commonEventObject :

• commonEventObject.userLocale — язык пользователя и идентификатор страны или региона. Например, en-US представляет английский язык, на котором говорят в Соединенных Штатах.
• commonEventObject.timeZone.offset — Смещение часового пояса пользователя в миллисекундах от всемирного координированного времени (UTC) .
• commonEventObject.timeZone.id — Идентификатор часового пояса пользователя. Например, America/New_York .
• commonEventObject.timeZone — Идентификатор и смещение часового пояса пользователя.

Объекты событий передаются функциям обратного вызова action , функциям homepageTrigger и функциям contextualTrigger , когда пользователь взаимодействует с надстройкой, например, нажимая кнопку. Каждая функция обратного вызова или триггера может получать информацию о локали и часовом поясе из объектов событий и использовать ее по мере необходимости. Например, функция обратного вызова, которая переходит к новой карточке , может ссылаться на строку языкового стандарта при принятии решения о том, какой текст добавить на карточку.