Określanie zlokalizowanych tekstów

Zalecamy obsługę lokalizacji w integracji list oczekujących w Centrum działań. Użytkownicy widzą zlokalizowaną wersję usługi na podstawie ustawień językowych. Jeśli nie skonfigurujesz lokalizacji, użytkownikowi może się wyświetlić tekst domyślny. W integracji możesz podać zlokalizowany tekst w wielu polach, np. w polach nazw i opisów usług. Pełną listę pól, które można zlokalizować za pomocą wiadomości Text, znajdziesz w naszej specyfikacji pliku danych.

Wdrażanie 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 plikach danych, które używa komunikatu Text, można przetłumaczyć, podając localized_value dla każdego obsługiwanego języka.

Musisz określić zarówno value, jak i localized_value.

  • Będziemy wyświetlać localized_value na podstawie ustawień regionalnych użytkownika (które są ustawione w ustawieniach języka przeglądarki).
  • Wartość będzie używana domyślnie, gdy język użytkownika nie będzie znajdować się na liście obsługiwanych wersji językowych.
    • Jeśli nie określisz wartości, a język użytkownika nie znajduje się na liście obsługiwanych wersji językowych, użyjemy pierwszej wartości w atrybucie localized_value. Chociaż ta opcja jest dostępna, zdecydowanie zalecamy wyraźne określenie wartości domyślnej.

Jeśli nie obsługujesz lokalizacji w swoim systemie, ustaw localized_value i locale z jedynym obsługiwanym językiem. Ustaw też value, które może być używane jako domyślne.

Przykładowy fragment kodu 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"
      }
    ]
  }