Specifica dei testi localizzati

Ti consigliamo vivamente di supportare la localizzazione nell'integrazione di Business Link per gli ordini al dettaglio di Actions Center. Agli utenti viene mostrata un'esperienza localizzata in base alle loro impostazioni linguistiche. Se non è impostata alcuna localizzazione, all'utente potrebbe essere mostrato il testo predefinito. Puoi fornire testo localizzato per molti campi dell'integrazione, ad esempio nomi e descrizioni dei servizi. Consulta la nostra specifica del feed per l'elenco completo dei campi che possono essere localizzati utilizzando il messaggio Text.

Implementazione della localizzazione

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

Qualsiasi campo nei feed che utilizza un messaggio Text può essere localizzato fornendo un localized_value per ogni lingua supportata.

È necessario specificare sia value che localized_value.

  • Mostreremo il localized_value in base alle impostazioni internazionali dell'utente (impostate nelle impostazioni del browser per la lingua dell'utente).
  • Il valore verrà utilizzato come predefinito quando le impostazioni internazionali dell'utente non sono presenti nell'elenco delle localizzazioni supportate.
    • Se non definisci il valore e le impostazioni internazionali dell'utente non sono presenti nel tuo elenco delle localizzazioni supportate, utilizzeremo il primo valore presente in localized_value. Sebbene questa opzione di riserva sia disponibile, ti consigliamo vivamente di specificare esplicitamente il valore predefinito.

Se non supporti la localizzazione nel tuo sistema, imposta localized_value e locale con l'unica lingua supportata. Imposta anche value, che può essere utilizzato come valore predefinito.

Esempio di snippet del feed di servizi

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