Lokalisierte Texte angeben

Wir empfehlen dringend, die Lokalisierung bei der Integration des Business Links für die Einzelhandelsbestellung im Actions Center zu unterstützen. Nutzer sehen eine lokalisierte Version, die auf ihren Spracheinstellungen basiert. Wenn keine Lokalisierung festgelegt ist, wird dem Nutzer möglicherweise der Standardtext angezeigt. Sie können für viele Felder in der Integration lokalisierten Text angeben, z. B. Dienstnamen und ‑beschreibungen. Eine vollständige Liste der Felder, die mithilfe der Text-Nachricht lokalisiert werden können, finden Sie in unserer Feedspezifikation.

Lokalisierung implementieren

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

Jedes Feld in den Feeds, für das eine Text-Nachricht verwendet wird, kann lokalisiert werden, indem für jede unterstützte Sprache eine localized_value angegeben wird.

Sie müssen sowohl value als auch localized_value angeben.

  • Die localized_value wird basierend auf der Sprache des Nutzers angezeigt, die in den Spracheinstellungen des Browsers des Nutzers festgelegt ist.
  • Der Wert wird als Standard verwendet, wenn die Sprache des Nutzers nicht in der Liste der unterstützten Lokalisierungen enthalten ist.
    • Wenn Sie keinen Wert definieren und die Sprache des Nutzers nicht in Ihrer Liste der unterstützten Lokalisierungen enthalten ist, wird der erste Wert in „localized_value“ verwendet. Dieser Fallback ist zwar verfügbar, wir empfehlen Ihnen jedoch dringend, den Standardwert explizit anzugeben.

Wenn Sie die Lokalisierung in Ihrem System nicht unterstützen, legen Sie localized_value und locale auf die einzige Sprache fest, die Sie unterstützen. Legen Sie auch value fest, das als Standard verwendet werden kann.

Beispiel für ein Snippet für einen Dienstleistungsfeed

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