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

Bạn nên hỗ trợ bản địa hoá trong các hoạt động tích hợp với Trung tâm hành động. Người dùng sẽ thấy trải nghiệm được bản địa hoá dựa trên chế độ cài đặt ngôn ngữ của họ. Nếu bạn không đặt ngôn ngữ bản địa hoá, thì văn bản mặc định có thể hiển thị với người dùng. Bạn có thể cung cấp văn bản đã bản địa hoá cho nhiều trường trong quá 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 để biết 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á bất kỳ trường nào 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 bắt buộc phải chỉ định cả value và localized_value.

  • Chúng ta 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).
  • Giá trị này 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 ngôn ngữ được hỗ trợ
    • 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 ngôn ngữ được hỗ trợ, chúng tôi sẽ sử dụng giá trị đầu tiên có trong localized_value. Mặc dù có thể sử dụng 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 bạn không hỗ trợ bản địa hoá trong hệ thống, vui lòng đặt localized_value và đặt locale bằng ngôn ngữ duy nhất mà bạn hỗ trợ. Ngoài ra, hãy đặt value có thể được dùng làm giá trị mặc định.

Ví dụ về đoạn mã 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"
      }
    ]
  }