Указание локализованных текстов

Настоятельно рекомендуется поддерживать локализацию в интеграции Action Center Retail Ordering Business Link. Пользователям предоставляется локализованный интерфейс в зависимости от их языковых настроек. Если локализация не установлена, пользователю может быть показан текст по умолчанию. Вы можете предоставить локализованный текст для многих полей интеграции, например для названий и описаний служб. Полный список полей, которые можно локализовать с помощью 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"
     
}
   
]
 
}