É altamente recomendável oferecer suporte à localização na integração de ponta a ponta
da Central de ações. Os usuários têm acesso a uma experiência localizada com base no idioma
configurações. Se nenhuma localização for definida, o texto padrão será exibido ao
usuário. Você pode fornecer texto localizado para muitos campos na
integração, como nomes e descrições de serviços. Consulte as
feed
especificação para a lista completa de campos que podem ser localizados usando a
Text
mensagem.
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; }
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 esse substituto esteja disponível, é altamente é recomendado especificar explicitamente o valor padrão.
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" } ] }