Spécifier des textes localisés

Nous vous recommandons vivement d'activer la localisation dans l'intégration de Réserver avec Google. Les utilisateurs bénéficient d'une expérience localisée en fonction de leurs paramètres linguistiques. Si aucune localisation n'est définie, l'utilisateur pourra voir le texte par défaut. Vous pouvez fournir du texte localisé pour de nombreux champs de l'intégration, tels que les noms de services et les descriptions. Veuillez consulter nos spécifications techniques 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;
}

Tous les champs des flux qui utilisent un message Text peuvent être localisés en fournissant un localized_value pour chaque langue acceptée.

Vous devez spécifier les champs value et localized_value.

  • Nous affichons localized_value en fonction des paramètres régionaux de l'utilisateur (définis dans les paramètres linguistiques du navigateur de l'utilisateur).
  • 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 acceptées, nous utiliserons la première valeur présente dans localized_value. Bien que cette création de remplacement soit disponible, nous vous recommandons vivement de spécifier explicitement la valeur par défaut.

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

Exemple d'extrait de flux des services

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