Como especificar textos localizados

É altamente recomendável oferecer suporte à localização na integração da Central de Ações com o link de negócios de pedidos de varejo. Os usuários recebem 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. Você pode fornecer texto localizado para muitos campos na integração, como nomes e descrições de serviços. Consulte nossa especificação do feed para conferir a lista completa de campos que podem ser localizados usando a mensagem Text.

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

Qualquer campo nos feeds que usa uma mensagem Text pode ser localizado fornecendo um localized_value para cada idioma aceito.

É necessário especificar value e localized_value.

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

Se você não oferece suporte à localização no seu sistema, defina localized_value e locale com o único idioma que você oferece suporte. Defina value também, que 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"
      }
    ]
  }