Actualizar las traducciones de una plantilla de correo electrónico
/templates/email/translations/
Utiliza este punto final para actualizar las traducciones de una plantilla de correo electrónico.
Este punto final se encuentra actualmente en acceso anticipado. Ponte en contacto con tu director de cuentas de Braze si estás interesado en participar en el acceso anticipado.
Requisitos previos
Para utilizar este punto final, necesitarás una clave de API con el permiso templates.translations.update
.
Límite de velocidad
Parámetros de la ruta
No hay parámetros de ruta para este punto final.
Parámetros de la solicitud
Parámetro | Obligatoria | Tipo de datos | Descripción |
---|---|---|---|
template_id |
Obligatoria | Cadena | El ID de tu plantilla de correo electrónico. |
locale_id |
Obligatoria | Cadena | El ID de la configuración regional. |
translations |
Obligatoria | Cadena | El mapeado de las traducciones para tu plantilla de correo electrónico. |
Ten en cuenta que todos los ID de traducción se consideran identificadores únicos universales (UUID), que puedes encontrar en la configuración de Soporte multilingüe o en la respuesta de la solicitud GET.
Ejemplo de solicitud
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"template_id": "e24404b3-3626-4de0-bdec-06935f3aa0ab",
"locale_id": "h94404b3-3626-4de0-bdec-06935f3aa0ad",
"translations": [
{
"translation_map": {
"id_0": "¡Hola!",
"id_1": "Me llamo Jacky",
"id_2": "¿Dónde está la biblioteca?"
}
}
]
}
Respuesta
Hay cuatro respuestas de código de estado para este punto final: 200
, 400
, 404
y 429
.
Ejemplo de respuesta positiva
1
2
3
{
"message": "success"
}
Ejemplo de respuesta de error
El código de estado 400
podría devolver el siguiente cuerpo de respuesta. Consulte la sección Solución de problemas para obtener más información sobre los errores que puede encontrar.
1
2
3
4
5
6
7
8
{
"errors": [
{
"id": "1234567-abc-123-012345678",
"message": "The provided translations yielded errors when parsing. Please contact Braze for more information."
}
]
}
Solución de problemas
La siguiente tabla enumera los posibles errores devueltos y los pasos asociados para solucionarlos.
Mensaje de error | Solución de problemas |
---|---|
The provided translations yielded errors when parsing. Please contact Braze for more information. |
Ocurre cuando el traductor externo proporciona traducciones con excepciones que generan errores Liquid. Ponte en contacto con el soporte de Braze para obtener más ayuda. |
The provided translations are missing 'id_1', 'id_2' |
Los ID de traducción no coinciden o el texto traducido supera los límites. Por ejemplo, esto podría significar que a la forma de la carga útil le faltan campos en el objeto de traducción. Cada mensaje (cuando está habilitado para la multiidioma) debe tener un número determinado de “bloques de traducción” con un ID asociado. Si a la carga útil proporcionada le falta alguno de los ID, se considerará un objeto incompleto y dará lugar a un error. |
The provided locale code does not exist. |
La carga útil del traductor externo contiene un código de localización que no existe en Braze. |
The provided translations have exceeded the maximum of 20MB. |
La carga útil proporcionada supera el límite de tamaño. |
You have exceeded the maximum number of requests. Please try again later. |
Todas las API de Braze tienen un límite de tasa incorporado, y este error se devolverá automáticamente cuando la tasa haya superado la cantidad asignada para este token de autenticación. |
This message does not support multi-language. |
Esto puede ocurrir cuando un ID de mensaje aún no admite mensajes en varios idiomas. Sólo se pueden traducir los mensajes de los siguientes canales: push, mensajes dentro de la aplicación y correo electrónico. |