Exibir uma tradução e localização específicas para o ponto de extremidade do modelo de e-mail
/templates/translations/email?locale_id={locale_uuid}&template_id={template_id}
Use esse ponto de extremidade para visualizar uma tradução e localização específicas para o ponto de extremidade de modelo de e-mail de um modelo de e-mail.
Esse ponto de extremidade 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 templates.translations.get
.
Limite de taxa
Esse 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 |
---|---|---|---|
template_id |
Obrigatória | String | O ID de seu modelo de e-mail. |
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/templates/translations/email?locale_id={locale_uuid}&template_id={template_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
19
20
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"translations": [
{
"locale": {
"uuid": "c7c12345-te35-1234-5678-abcdefa99r3f",
"name": "es-MX",
"country": "MX",
"language": "es",
"locale_key": "es-mx"
},
"translation_map": {
"id_0": "¡Hola!",
"id_1": "Me llamo Jacky",
"id_2": "¿Dónde está la biblioteca?"
}
}
]
}
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": "The provided locale code does not exist."
}
]
}
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_LOCALE_ID |
Confirme se o ID da localização existe na tradução da mensagem. |
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 modelos de e-mail e campanhas de mensagens por e-mail, push e mensagens no app ou mensagens do Canvas com e-mails podem ser traduzidos. |