Określ zlokalizowane teksty

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"
      }
    ]
  }