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

Bạn nên hỗ trợ bản địa hoá cho tính năng tích hợp toàn diện đối với cuộc hẹn trong Trung tâm hành động. Người dùng sẽ thấy trải nghiệm đã bản địa hoá dựa trên chế độ cài đặt ngôn ngữ. Nếu bạn không đặt thông tin 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 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 của chúng tôi để biết danh sách đầy đủ các trường có thể bản địa hoá bằ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 mỗi 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 trình duyệt ngôn ngữ của người dùng).
• Giá trị này sẽ được dùng làm mặc định khi ngôn ngữ của người dùng không có trong danh sách nội dung bản địa đượ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 nội dung bản địa hoá được hỗ trợ, chúng tôi sẽ sử dụng giá trị đầu tiên có trong bản địa hoá_value. Mặc dù có sẵn tính năng dự phòng này, bạn nên chỉ định rõ ràng giá trị mặc định.

Nếu bạn không hỗ trợ bản địa hoá trong hệ thống của mình, vui lòng đặt localized_value và thiết lập locale bằng ngôn ngữ duy nhất mà bạn hỗ trợ. Đồng thời đặ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"
      }
    ]
  }