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. | 
 Editar esta página no GitHub
   Editar esta página no GitHub