Specify localized texts

  • Supporting localization in the Actions Center Reservations End-to-End integration is highly recommended to provide a localized experience based on user language settings.

  • You can provide localized text for fields like service names and descriptions using the Text message in the feed specification.

  • To implement localization, provide a localized_value for each supported language for any field using a Text message.

  • Both value and localized_value are required; localized_value is shown based on user locale, while value is used as a default if the user's locale is not supported.

  • If you do not support localization, set localized_value and locale to the only language supported, and set value as a default.

It is highly recommended to support localization in the Actions Center Reservations End-to-End integration. Users are shown a localized experience based on their language settings. If no localization is set, the default text may be shown to the user. You are able to provide localized text for many fields in the integration, such as service names and descriptions. Please refer to our feed specification for the full list of fields that can be localized by using the Text message.

Implementing localization

// 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;
}

Any field in the feeds that uses a Text message can be localized by providing a localized_value for each supported language.

It is required to specify both the value and localized_value.

  • We will show the localized_value based on the user’s locale (which is set in the user’s language browser settings).
  • Value will be used as a default when the user’s locale is not in your list of supported localizations
    • 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.

If you do not support localization in your system, please set localized_value and set locale with the only language you support. Set value as well which may be used as a default.

Example Services Feed Snippet

  "localized_service_name": {
    "value": "Chocolate Tasting",
    "localized_value": [
      {
        "locale": "en",
        "value": "Chocolate Tasting"
      },
      {
        "locale": "fr",
        "value": "Dégustation de chocolats"
      }
    ]
  }