Spécifier les textes localisés

Nous vous recommandons vivement de faciliter la localisation dans l'intégration de bout en bout des rendez-vous dans le centre d'actions. Les utilisateurs voient une expérience localisée en fonction de leurs paramètres de langue. Si aucune localisation n'est définie, le texte par défaut peut être présenté à l'utilisateur. Vous pouvez fournir du texte localisé pour de nombreux champs de l'intégration, tels que les noms et les descriptions des services. Veuillez consulter les spécifications du flux pour obtenir la liste complète des champs pouvant être localisés à l'aide du message Text.

Implémenter la localisation

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

Tout champ des flux qui utilise un message Text peut être localisé en fournissant une valeur localized_value pour chaque langue acceptée.

Vous devez spécifier à la fois value et localized_value.

• Nous afficherons localized_value en fonction des paramètres régionaux de l'utilisateur (définis dans les paramètres de langue de son navigateur).
• Cette valeur est utilisée par défaut lorsque les paramètres régionaux de l'utilisateur ne figurent pas dans votre liste de localisations compatibles.
  • Si vous ne définissez pas de valeur et que les paramètres régionaux de l'utilisateur ne figurent pas dans votre liste de localisations compatibles, nous utiliserons la première valeur présente dans localized_value. Bien que cette valeur de remplacement soit disponible, nous vous recommandons vivement de spécifier explicitement la valeur par défaut.

Si la localisation n'est pas disponible sur votre système, veuillez définir localized_value et locale sur la seule langue que vous proposez. Définissez également value, qui peut être utilisé par défaut.

Exemple d'extrait de flux de services

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