Como especificar textos localizados

É altamente recomendável oferecer suporte à localização na integração do Link comercial de pedidos de varejo da Central de Ações. Os usuários veem uma experiência localizada com base nas configurações de idioma. Se nenhuma localização for definida, o texto padrão poderá ser mostrado ao usuário. É possível fornecer texto localizado para muitos campos na integração, como nomes e descrições de serviços. Consulte nossa especificação de feed para ver uma lista completa de campos que podem ser localizados usando a mensagem Text.

Como implementar a localização

// 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;
}

Para localizar qualquer campo nos feeds que use uma mensagem de Text, basta fornecer um localized_value para cada idioma aceito.

É necessário especificar value e localized_value.

• Mostraremos o localized_value com base na localidade do usuário, definida nas configurações de idioma do navegador.
• O valor será usado como padrão quando a localidade do usuário não estiver na sua lista de localizações compatíveis
  • Se você não definir o valor e a localidade do usuário não estiver na sua lista de localizações com suporte, usaremos o primeiro valor presente em localized_value. Embora esse substituto esteja disponível, é altamente recomendável especificar explicitamente o valor padrão.

Se o sistema não oferecer suporte à localização, defina localized_value e defina locale com o único idioma compatível. Defina value, que também pode ser usado como padrão.

Exemplo de snippet de feed de serviços

  "localized_service_name": {
    "value": "Chocolate Tasting",
    "localized_value": [
      {
        "locale": "en",
        "value": "Chocolate Tasting"
      },
      {
        "locale": "fr",
        "value": "Dégustation de chocolats"
      }
    ]
  }