Доступ к языковому стандарту и часовому поясу пользователя

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Надстройки могут получить доступ к локали и часовому поясу своего пользователя и использовать эту информацию для настройки своего интерфейса и поведения. Вы должны настроить манифест надстройки, чтобы разрешить надстройке доступ к этой информации.

Настройте манифест надстройки

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

  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 — идентификатор и смещение часового пояса пользователя.

Дополнительные сведения см. в разделе Объекты событий .

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