Listar traduções de um canva
/canvases/translations
Use esse ponto de extremidade para visualizar todas as traduções de um Canva.
A visualização de traduções de um canva 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 canvas.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 |
---|---|---|---|
step_id |
Obrigatória | String | O ID de sua etapa do canva. |
message_variation_id |
Obrigatória | String | O ID de sua mensagem. |
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/canvas/translations' \
--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": "zh-HK",
"country": "Hong Kong",
"language": "Chinese (Traditional)",
},
"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": "This message does not support multi-language."
}
]
}
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_MESSAGE_VARIATION_ID |
Confirme se o ID da mensagem está correto. |
MESSAGE_NOT_FOUND |
Verifique se a mensagem a ser traduzida está correta. |
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. |