Chỉ định văn bản đã bản địa hoá

Bạn nên hỗ trợ bản địa hoá trong quá trình tích hợp Danh sách chờ đặt chỗ của Actions Center. Người dùng sẽ thấy trải nghiệm phù hợp với ngôn ngữ dựa trên chế độ cài đặt ngôn ngữ của họ. Nếu bạn không đặt chế độ bản địa hoá, thì người dùng có thể thấy văn bản mặc định. Bạn có thể cung cấp văn bản đã bản địa hoá cho nhiều trường trong quy trình tích hợp, chẳng hạn như tên và nội dung mô tả dịch vụ. Vui lòng tham khảo quy cách nguồn cấp dữ liệu để xem danh sách đầy đủ các trường có thể được bản địa hoá bằng cách sử dụng thông báo Text.

Triển khai bản địa hoá

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

Bạn có thể bản địa hoá mọi trường trong nguồn cấp dữ liệu sử dụng thông báo Text bằng cách cung cấp localized_value cho từng ngôn ngữ được hỗ trợ.

Bạn phải chỉ định cả value và localized_value.

  • Chúng tôi sẽ hiển thị localized_value dựa trên ngôn ngữ của người dùng (được đặt trong chế độ cài đặt ngôn ngữ của trình duyệt người dùng).
  • Giá trị sẽ được dùng làm giá trị mặc định khi ngôn ngữ của người dùng không có trong danh sách bản bản địa hoá được hỗ trợ của bạn
    • Nếu bạn không xác định giá trị và ngôn ngữ của người dùng không có trong danh sách các bản bản địa hoá được hỗ trợ, chúng tôi sẽ sử dụng giá trị đầu tiên có trong localized_value. Mặc dù có sẵn phương án dự phòng này, nhưng bạn nên chỉ định giá trị mặc định một cách rõ ràng.

Nếu không hỗ trợ bản địa hoá trong hệ thống, vui lòng đặt localized_value và đặt locale chỉ với ngôn ngữ mà bạn hỗ trợ. Đặt value cũng có thể được dùng làm giá trị mặc định.

Ví dụ về đoạn trích nguồn cấp dữ liệu dịch vụ

  "localized_service_name": {
    "value": "Chocolate Tasting",
    "localized_value": [
      {
        "locale": "en",
        "value": "Chocolate Tasting"
      },
      {
        "locale": "fr",
        "value": "Dégustation de chocolats"
      }
    ]
  }