指定本地化文本

强烈建议在 Actions Center 预留端到端集成中支持本地化。系统会根据用户的语言设置向用户显示本地化的体验。如果未设置本地化,系统可能会向用户显示默认文本。您可以为集成中的许多字段(例如服务名称和说明)提供本地化文本。请参阅我们的 Feed 规范,查看可使用 Text 消息进行本地化的字段的完整列表。

实现本地化

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

Feed 中使用 Text 消息的任何字段都可以通过为每种受支持的语言提供一个 localized_value 来进行本地化。

您必须同时指定 valuelocalized_value

  • 我们将根据用户的语言区域(在用户的语言浏览器设置中设置)显示 localized_value
  • 当用户的语言区域不在您的受支持本地化版本列表中时,系统会将该值用作默认值
    • 如果您未定义值,并且用户的语言区域未包含在受支持的本地化列表中,我们将使用 localized_value 中存在的第一个值。虽然可以使用此回退机制,但我们强烈建议您明确指定默认值。

如果您的系统不支持本地化,请设置 localized_value,并将 locale 设置为您支持的唯一语言。同时设置 value,它可以用作默认值。

服务 Feed 代码段示例

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