Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Надстройки 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 — идентификатор часового пояса пользователя и смещение.
Объекты событий передаются в функции обратного вызова действий , когда пользователь взаимодействует с вашим дополнением, а также в функции домашней страницы и контекстного триггера. Каждая функция обратного вызова или триггера может считывать информацию о локали и часовом поясе из объекта события и использовать ее по мере необходимости. Например, функция обратного вызова, которая осуществляет навигацию к новой карточке, может ссылаться на строку локали при принятии решения о том, какой текст добавить к карточке.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-06-05 UTC."],[[["Google Workspace add-ons can be configured to access and utilize a user's locale and timezone for customization."],["Add-on developers must set `addOns.common.useLocaleFromApp` to `true` and include the `https://www.googleapis.com/auth/script.locale` scope in the manifest file for locale and timezone access."],["Event objects provide the user's locale and timezone information through fields like `userLocale`, `timeZone.offset`, and `timeZone.id`, which add-ons can utilize in their functions."],["After adding the necessary scope, users need to re-authorize the add-on for the changes to take effect."],["Add-ons should only request necessary scopes and consider removing unused ones, especially those previously used for locale and timezone access through other APIs or services."]]],["Google Workspace add-ons can access user locale and timezone by configuring the add-on manifest. Set `addOns.common.useLocaleFromApp` to `true` and add `https://www.googleapis.com/auth/script.locale` to `oauthScopes`. This requires users to re-authorize the add-on. Event objects contain `userLocale`, `timeZone.offset`, and `timeZone.id`. Callback functions and trigger functions read this information from the event object to customize the add-on's interface and behavior, such as text on cards.\n"]]
