Получить локаль и часовой пояс пользователя

Дополнения 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 — смещение часового пояса пользователя в миллисекундах от всемирного координированного времени (UTC).
  • commonEventObject.timeZone.id — Идентификатор часового пояса пользователя. Например, America/New_York .
  • commonEventObject.timeZone — Идентификатор и смещение часового пояса пользователя.

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

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

,

Дополнения 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 — смещение часового пояса пользователя в миллисекундах от всемирного координированного времени (UTC).
  • commonEventObject.timeZone.id — Идентификатор часового пояса пользователя. Например, America/New_York .
  • commonEventObject.timeZone — Идентификатор и смещение часового пояса пользователя.

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

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

,

Дополнения 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 — смещение часового пояса пользователя в миллисекундах от всемирного координированного времени (UTC).
  • commonEventObject.timeZone.id — Идентификатор часового пояса пользователя. Например, America/New_York .
  • commonEventObject.timeZone — Идентификатор и смещение часового пояса пользователя.

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

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