Ver todas as traduções de uma campanha
/campaigns/translations
Use esse ponto de extremidade para visualizar todas as traduções de cada variante de mensagens em uma campanha. Veja Locales in messages para saber mais sobre os recursos de tradução.
This endpoint está atualmente em acesso antecipado. Entre em contato com seu gerente de conta Braze se estiver interessado em participar do acesso antecipado.
Pré-requisitos
Para usar esse endpoint, você precisará de uma chave de API com a permissão campaigns.translations.get.
Limite de taxa
Este endpoint tem um limite de frequência de 250.000 solicitações por minuto.
Parâmetros de consulta
| Parâmetro | Obrigatória | Tipo de dados | Descrição |
|---|---|---|---|
campaign_id |
Obrigatória | String | O ID de sua campanha. |
message_variation_id |
Obrigatória | String | O ID da sua variação de mensagem. |
locale_id |
Opcional | String | Um UUID de localidade para filtrar as respostas. |
post_launch_draft_version |
Opcional | Booleano | Quando true retorna a versão mais recente do rascunho em vez da versão publicada mais recente. Padrão para false retornando a versão publicada mais recente. |
Todos os IDs de tradução são considerados identificadores únicos universais (UUIDs), que podem ser encontrados na resposta do endpoint GET.
Exemplo de solicitação
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'
Resposta
Há quatro respostas de código de status para esse endpoint: 200, 400, 404, e 429.
Exemplo de resposta bem-sucedida
O código de status 200 poderia retornar o seguinte cabeçalho e corpo de resposta.
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"
}
}
]
}
Exemplo de resposta de erro
O código de status 400 pode retornar o seguinte corpo de resposta.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "This message does not support multi-language."
}
]
}
Editar esta página no GitHub