Skip to content

Ver todas las traducciones de una campaña

get

/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.

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 Obligatorio Tipo de datos Descripción
campaign_id Obligatorio Cadena El ID de tu campaña.
message_variation_id Obligatorio 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.

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."
		}
	]
}
New Stuff!