Cómo especificar textos localizados

Se recomienda admitir la localización en las integraciones de Acciones Central. A los usuarios se les muestra una experiencia localizada según su configuración de idioma. Si no se establece ninguna localización, es posible que se le muestre al usuario el texto predeterminado. Puedes proporcionar texto localizado para muchos campos de la integración, como los nombres y las descripciones de los servicios. Consulta nuestras especificaciones del feed para obtener la lista completa de los campos que se pueden localizar con el mensaje Text.

Implementa la localización

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

Cualquier campo de los feeds que use un mensaje Text se puede localizar proporcionando un localized_value para cada idioma admitido.

Es obligatorio especificar value y localized_value.

  • Mostraremos el localized_value según la configuración regional del usuario (que se establece en la configuración de idioma del navegador del usuario).
  • El valor se usará de forma predeterminada cuando la configuración regional del usuario no esté en tu lista de localizaciones admitidas.
    • Si no defines el valor y la configuración regional del usuario no está en tu lista de localizaciones admitidas, usaremos el primer valor presente en localized_value. Si bien este resguardo está disponible, te recomendamos que especifiques el valor predeterminado de forma explícita.

Si no admites la localización en tu sistema, configura localized_value y locale con el único idioma que admites. También establece value, que se puede usar como valor predeterminado.

Ejemplo de fragmento de feed de servicios

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