Specificare i testi localizzati

Ti consigliamo vivamente di supportare la localizzazione nell'integrazione Prenotazioni end-to-end 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"
      }
    ]
  }