Zdecydowanie zalecamy obsługę lokalizacji w ramach kompleksowej integracji spotkań w Centrum działań. Użytkownicy zobaczą zlokalizowaną wersję na podstawie swoich ustawień językowych. Jeśli nie ustawisz żadnej lokalizacji, użytkownik może wyświetlić tekst domyślny. Możesz udostępnić przetłumaczony tekst dla wielu pól w integracji, takich jak nazwy i opisy usług. Pełną listę pól, które można zlokalizować, korzystając z komunikatu Text
, znajdziesz w specyfikacji pliku danych.
Wdrożenie lokalizacji
// 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; }
Każde pole w pliku danych, które zawiera komunikat Text
, można przetłumaczyć, dodając właściwość localized_value
dla każdego obsługiwanego języka.
Musisz określić zarówno value
, jak i localized_value
.
localized_value
będzie wyświetlany na podstawie języka użytkownika (określonego w ustawieniach języka w przeglądarce).- Ta wartość będzie używana jako domyślna, jeśli języka użytkownika nie ma na liście obsługiwanych lokalizacji.
- Jeśli nie określisz wartości, a języka użytkownika nie ma na liście obsługiwanych lokalizacji, użyjemy pierwszej wartości zawartej w tagu localized_value. Chociaż ta wartość zastępcza jest dostępna, zdecydowanie zalecamy jawne określenie wartości domyślnej.
Jeśli Twój system nie obsługuje lokalizacji, ustaw localized_value
i locale
, używając jedynego obsługiwanego języka. Ustaw także właściwość value
, która może być używana jako domyślna.
Przykładowy fragment pliku danych o usługach
"localized_service_name": { "value": "Chocolate Tasting", "localized_value": [ { "locale": "en", "value": "Chocolate Tasting" }, { "locale": "fr", "value": "Dégustation de chocolats" } ] }