Określanie zlokalizowanych tekstów
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zdecydowanie zalecamy obsługę lokalizacji w ramach kompleksowej integracji rezerwacji w Centrum działań. Użytkownicy widzą zlokalizowaną wersję na podstawie swoich ustawień języka. Jeśli nie ustawisz lokalizacji, użytkownik może zobaczyć tekst domyślny. Możesz podać zlokalizowany tekst w wielu polach integracji, takich jak nazwy i opisy usług. Pełną listę pól, które można zlokalizować za pomocą wiadomości Text, znajdziesz w specyfikacji pliku danych.
Implementacja lokalizacji
// 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;
}
Wszelkie pola w plikach danych, które używają wiadomości Text, można zlokalizować, podając wiadomość localized_value w każdym obsługiwanym języku.
Musisz określić zarówno value, jak i localized_value.
localized_value będzie wyświetlany na podstawie lokalizacji użytkownika (ustalonej w ustawieniach języka przeglądarki użytkownika).- Wartość będzie używana domyślnie, gdy język użytkownika nie znajduje się na liście obsługiwanych lokalizacji.
- Jeśli nie zdefiniujesz wartości, a język użytkownika nie znajduje się na liście obsługiwanych lokalizacji, użyjemy pierwszej wartości w localized_value. Mimo że ta wartość zastępcza jest dostępna, zdecydowanie zalecamy określenie wartości domyślnej w sposób jawny.
Jeśli nie obsługujesz lokalizacji w swoim systemie, ustaw localized_value i locale z jedynym obsługiwanym językiem. Ustaw także value, który może być używany jako domyślny.
Przykładowy fragment pliku danych o usługach
"localized_service_name": {
"value": "Chocolate Tasting",
"localized_value": [
{
"locale": "en",
"value": "Chocolate Tasting"
},
{
"locale": "fr",
"value": "Dégustation de chocolats"
}
]
}
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\u003cp\u003eLocalization in Actions Center Reservations is highly recommended to provide users with a tailored experience based on their language settings.\u003c/p\u003e\n"],["\u003cp\u003eLocalizable fields, such as service names and descriptions, can be found in the feed specification, and are identified by utilizing the \u003ccode\u003eText\u003c/code\u003e message type.\u003c/p\u003e\n"],["\u003cp\u003eImplementing localization involves providing both a default \u003ccode\u003evalue\u003c/code\u003e and \u003ccode\u003elocalized_value\u003c/code\u003e entries within the \u003ccode\u003eText\u003c/code\u003e message, enabling the system to display the appropriate text based on the user's locale.\u003c/p\u003e\n"],["\u003cp\u003eIf localization is not supported, it's crucial to specify the \u003ccode\u003elocalized_value\u003c/code\u003e and \u003ccode\u003elocale\u003c/code\u003e with the supported language, while also setting the default \u003ccode\u003evalue\u003c/code\u003e for fallback purposes.\u003c/p\u003e\n"]]],["Localization is strongly recommended in the Actions Center Reservations integration. Fields using the `Text` message can be localized by specifying a `localized_value` for each supported language and a default `value`. The user's locale, from their browser settings, determines which `localized_value` is displayed. If the user's locale isn't found, the provided `value` is the default. If `value` is not set, the first value from `localized_value` is used. Even for single-language support, set both `value` and `localized_value`.\n"],null,["# Specify localized texts\n\nIt is highly recommended to support localization in the Actions Center Reservations 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/reservations/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```"]]
