Exibir a tradução de uma campanha
/campaign/translations/?locale_id={locale_id}
Use esse ponto de extremidade para visualizar uma mensagem de campanha traduzida e ver como essa mensagem se parece para um usuário.
A visualização de uma mensagem de campanha traduzida via API 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
Esse endpoint tem um limite de frequência de 250.000 solicitações por hora.
Parâmetros da jornada
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 | A ID de sua variação de mensagem. |
locale_id |
Obrigatória | String | O ID da localização. |
Note que todas as IDs de tradução são consideradas identificadores únicos universais (UUIDs), que podem ser encontrados nas configurações do Suporte multilíngue ou na resposta da solicitação.
Exemplo de solicitação
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/campaign/translations/?locale_id={locale_id}' \
--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
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"translations": [
{
"locale": {
"name": "es-MX",
"country": "Mexico",
"language": "Spanish",
},
"translation_map": {
"id_0": "Hello",
"id_1": "My name is Jacky",
"id_2": "Where is the library?"
}
}
]
}
Exemplo de resposta de erro
O código de status 400
poderia retornar o seguinte corpo de resposta. Consulte Solução de problemas para obter mais informações sobre os erros que você pode encontrar.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "Invalid locale ID"
}
]
}
Solução de problemas
A tabela a seguir lista os possíveis erros retornados e as etapas de solução de problemas associadas.
Mensagem de erro | Solução de problemas |
---|---|
INVALID_CAMPAIGN_ID |
Confirme se o ID da campanha corresponde à campanha que você está traduzindo. |
INVALID_LOCALE_ID |
Confirme se o ID da localização existe na tradução da mensagem. |
INVALID_MESSAGE_VARIATION_ID |
Confirme se o ID da mensagem está correto. |
MESSAGE_NOT_FOUND |
Verifique se a mensagem a ser traduzida está correta. |
LOCALE_NOT_FOUND |
Confirme se a localização existe em suas configurações de vários idiomas. |
MULTI_LANGUAGE_NOT_ENABLED |
As configurações de vários idiomas não estão ativadas em seu espaço de trabalho. |
MULTI_LANGUAGE_NOT_ENABLED_ON_MESSAGE |
Somente as campanhas de e-mail ou as mensagens de canva com e-mails podem ser traduzidas. |
UNSUPPORTED_CHANNEL |
Somente mensagens em campanhas de mensagens ou mensagens de canvas com e-mails podem ser traduzidas. |