Ver todas las traducciones de una campaña
/campaigns/translations
Usa este punto de conexión para ver todas las traducciones de cada variante de mensaje en una campaña. Consulta Locales en los mensajes para obtener más información sobre las características de traducción.
This endpoint Actualmente se encuentra en fase de 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 usar este punto de conexión, necesitarás una clave de API con el permiso campaigns.translations.get.
Límite de velocidad
Este punto de conexión tiene un límite de velocidad de 250 000 solicitudes por minuto.
Parámetros de consulta
| Parámetro | Obligatoria | Tipo de datos | Descripción |
|---|---|---|---|
campaign_id |
Obligatoria | Cadena | El ID de tu campaña. |
message_variation_id |
Obligatoria | Cadena | El ID de tu variante de mensaje. |
locale_id |
Opcional | Cadena | Un UUID de locale para filtrar las respuestas. |
post_launch_draft_version |
Opcional | Booleano | Cuando es true, devuelve la última versión de borrador en lugar de la última versión publicada en vivo. El valor predeterminado es false, que devuelve la última versión en vivo. |
Todos los ID de traducción se consideran identificadores únicos universales (UUID), que se pueden encontrar en la respuesta del punto de conexión GET.
Ejemplo de solicitud
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/campaigns/translations?campaign_id={campaign_id}&message_variation_id={message_variation_id}&locale_id={locale_uuid}&post_launch_draft_version=true' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Respuesta
Hay cuatro respuestas de código de estado para este punto de conexión: 200, 400, 404 y 429.
Ejemplo de respuesta correcta
El código de estado 200 podría devolver el siguiente encabezado y cuerpo de respuesta.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
"translations": [
{
"translation_map": {
"id_0": "¡Hola!",
"id_1": "Me llamo Jacky",
"id_2": "¿Dónde está la biblioteca?"
},
"locale": {
"uuid": "c7c12345-te35-1234-5678-abcdefa99r3f",
"name": "es-MX",
"country": "MX",
"language": "es",
"locale_key": "es-mx"
}
},
{
"translation_map": {
"id_0": "你好",
"id_1": "我的名字是 Jacky",
"id_2": "圖書館在哪裡?"
},
"locale": {
"uuid": "a1b12345-cd35-1234-5678-abcdefa99r3f",
"name": "zh-HK",
"country": "HK",
"language": "zh",
"locale_key": "zh-hk"
}
}
]
}
Ejemplo de respuesta de error
El código de estado 400 podría devolver el siguiente cuerpo de respuesta.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "This message does not support multi-language."
}
]
}