Atualizar a tradução em uma tela
/canvas/translations
Use esse endpoint para alterar várias traduções para um canva. Veja Locais em mensagens para saber mais sobre os recursos de tradução.
Se você quiser atualizar as traduções depois que um canva for lançado, precisará salvar sua mensagem como um rascunho primeiro.
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 canvas.translations.update.
Limite de taxa
Este endpoint tem um limite de frequência de 250.000 solicitações por minuto.
Parâmetros da jornada
Não há parâmetros de jornada para este endpoint.
Parâmetros de solicitação
| Parâmetro | Obrigatória | Tipo de dados | Descrição |
|---|---|---|---|
workflow_id |
Obrigatória | String | O ID do canva. |
step_id |
Obrigatória | String | O ID de sua etapa do canva. |
message_variation_id |
Obrigatória | String | O ID da sua variação de mensagem. |
locale_id |
Obrigatória | String | O ID (UUID) do local. |
translation_map |
Obrigatória | Objeto | Objeto contendo as novas traduções. |
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
4
5
6
7
8
9
{
"workflow_id": "a74404b3-3626-4de0-bdec-06935f3aa0ad",
"step_id": "a74404b3-3626-4de0-bdec-06935f3aa0ac",
"message_variation_id": "a74404b3-3626-4de0-bdec-06935f3aa0ac",
"locale_id": "h94404b3-3626-4de0-bdec-06935f3aa0ad",
"translation_map": {
"id_3": "Ein Absatz ohne Formatierung"
}
}
Resposta
Há quatro respostas de código de status para esse endpoint: 200, 400, 404, e 429.
Exemplo de resposta bem-sucedida
1
2
3
{
"message": "success"
}
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."
}
]
}
Editar esta página no GitHub