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 Lịch hẹn toàn diện của 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 ngôn ngữ của họ phần cài đặt. 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ị 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 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 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 cho người dùng).
  • 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 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ủa bạn của 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á giá trị. Mặc dù có thể sử dụng phương án dự phòng này, nhưng 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, 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 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"
      }
    ]
  }