Atualizar tradução em um Canvas
/canvas/translations
Use esse endpoint para atualizar várias traduções para um Canvas. Consulte Locais em mensagens para saber mais sobre os recursos de tradução.
Se você quiser atualizar as traduções depois que um Canvas for lançado, precisará salvar sua mensagem como 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
Esse endpoint tem um limite de taxa de 250.000 solicitações por minuto.
Parâmetros de caminho
Não há parâmetros de caminho 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 Canvas. |
step_id |
Obrigatória | String | O ID da sua etapa do Canvas. |
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."
}
]
}