Chỉ định văn bản đã bản địa hoá
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Bạn nên hỗ trợ bản địa hoá trong quá trình tích hợp Quảng cáo dịch vụ địa phương toàn diện của 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ợ. Hãy đặt value cũng có thể được dùng làm giá trị mặc định.
Đoạn mã nguồn cấp dữ liệu dịch vụ mẫu
"localized_service_name": {
"value": "Chocolate Tasting",
"localized_value": [
{
"locale": "en",
"value": "Chocolate Tasting"
},
{
"locale": "fr",
"value": "Dégustation de chocolats"
}
]
}
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eLocalizing Actions Center Local Services Ads is highly recommended to provide users with a tailored experience based on their language settings.\u003c/p\u003e\n"],["\u003cp\u003eLocalization can be achieved by providing translated text for various fields, such as service names and descriptions, as detailed in the feed specification.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eText\u003c/code\u003e message structure allows for specifying a default value and localized values for supported languages, ensuring content is displayed appropriately.\u003c/p\u003e\n"],["\u003cp\u003eWhen a user's locale is not supported, either the default value or the first provided localized value will be displayed as a fallback.\u003c/p\u003e\n"],["\u003cp\u003eEven without full localization support, setting a default value and a single localized value for the supported language is advised for consistency.\u003c/p\u003e\n"]]],["Localization is strongly encouraged within the Actions Center Local Services Ads integration. Fields using the `Text` message can be localized by providing a `localized_value` for each supported language and a default `value`. The user's language settings determine which `localized_value` is shown. If no locale match exists, the `value` acts as the default; or the first value in localized_value will be used. If localization is not supported, a single `localized_value` and `value` should be provided.\n"],null,["# Specify localized texts\n\nIt is highly recommended to support localization in the Actions Center Local Services Ads End-to-End\nintegration. Users are shown a localized experience based on their language\nsettings. If no localization is set, the default text may be shown to the\nuser. You are able to provide localized text for many fields in the\nintegration, such as service names and descriptions. Please refer to our\n[feed\nspecification](/actions-center/verticals/local-services/e2e/integration-steps/feeds) for the full list of fields that can be localized by using the\n`Text` message.\n\nImplementing localization\n-------------------------\n\n```mysql\n// A possibly-localized text payload. Some Text fields may contain marked-up\n// content.\nmessage Text {\n // Required. Text value in an unknown locale, which will be displayed if\n // `localized_value` for the user locale is empty or missing. The locale for\n // this value may depend on the partner or service provider, and it should not\n // be assumed to be any specific language.\n string value = 1;\n\n // Per-locale text values. Required.\n repeated LocalizedString localized_value = 2;\n}\n```\n\nAny field in the feeds that uses a `Text` message can be localized by providing\na `localized_value` for each supported language.\n\nIt is required to specify both the `value` and\n`localized_value`.\n\n- We will show the `localized_value` based on the user's locale (which is set in the user's language browser settings).\n- Value will be used as a default when the user's locale is not in your list of supported localizations\n - Should you not define value and the users locale is not in your list of supported localizations we will use the first value present in localized_value. While this fallback is available it is strongly recommend for you to specify the default value explicitly.\n\nIf you do not support localization in your system, please set\n`localized_value` and set `locale` with the only\nlanguage you support. Set `value` as well which may be used as a\ndefault.\n\nExample Services Feed Snippet\n-----------------------------\n\n```scdoc\n \"localized_service_name\": {\n \"value\": \"Chocolate Tasting\",\n \"localized_value\": [\n {\n \"locale\": \"en\",\n \"value\": \"Chocolate Tasting\"\n },\n {\n \"locale\": \"fr\",\n \"value\": \"Dégustation de chocolats\"\n }\n ]\n }\n```"]]
