Chỉ định văn bản được bản địa hoá

Bạn nên hỗ trợ việc bản địa hoá trong quá trình tích hợp Đặt chỗ với Google. Người dùng sẽ thấy một trải nghiệm bản địa hoá dựa trên chế độ cài đặt ngôn ngữ của họ. Nếu bạn chưa đặt nội dung bản địa hóa nào, văn bản mặc định có thể được hiển thị cho 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 dịch vụ và nội dung mô tả. Vui lòng tham khảo quy cách nguồn cấp dữ liệu của chúng tôi để xem 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 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 phần cài đặt trình duyệt ngôn ngữ của 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 địa hoá được hỗ trợ của bạn
  • Nếu bạn không xác định giá trị và ngôn ngữ người dùng không có trong danh sách bản địa hoá được hỗ trợ, chúng tôi sẽ sử dụng giá trị đầu tiên có trong ngôn ngữ bản địa hoá. Mặc dù có sẵn phương án dự phòng này, nhưng bạn nên chỉ định rõ giá trị mặc định.

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ợ. Đặt value cũng có thể được dùng làm 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"
      }
    ]
  }