Настоятельно рекомендуется поддерживать локализацию при интеграции с Центром действий. Пользователям предоставляется локализованный интерфейс в зависимости от их языковых настроек. Если локализация не установлена, пользователю может быть показан текст по умолчанию. Вы можете предоставить локализованный текст для многих полей интеграции, например для названий и описаний служб. Полный список полей, которые можно локализовать с помощью Text
сообщения, см. в спецификации нашего фида .
Реализация локализации
// A possibly-localized text payload. Some Text fields may contain marked-up // content. message Text { // Required. Text value in an unknown locale, which will be displayed if // `localized_value` for the user locale is empty or missing. The locale for // this value may depend on the partner or service provider, and it should not // be assumed to be any specific language. string value = 1; // Per-locale text values. Required. repeated LocalizedString localized_value = 2; }
Любое поле в каналах, использующее Text
сообщение, можно локализовать, указав localized_value
для каждого поддерживаемого языка.
Необходимо указать как value
, так и localized_value
.
- Мы покажем
localized_value
на основе языкового стандарта пользователя (который установлен в настройках браузера языка пользователя). - Значение будет использоваться по умолчанию, если локаль пользователя отсутствует в списке поддерживаемых локализаций.
- Если вы не определили значение и языковой стандарт пользователя отсутствует в вашем списке поддерживаемых локализаций, мы будем использовать первое значение, присутствующее в localized_value. Хотя этот запасной вариант доступен, настоятельно рекомендуется явно указать значение по умолчанию.
Если вы не поддерживаете локализацию в своей системе, установите localized_value
и установите locale
для единственного поддерживаемого вами языка. Также установите value
, которое можно использовать по умолчанию.
Пример фрагмента фида услуг
"localized_service_name": { "value": "Chocolate Tasting", "localized_value": [ { "locale": "en", "value": "Chocolate Tasting" }, { "locale": "fr", "value": "Dégustation de chocolats" } ] }