Mise à jour de la traduction dans un Canvas
/canvas/translations
Utilisez cet endpoint pour mettre à jour plusieurs traductions pour un Canvas. Consultez la section Locales dans les messages pour plus d’informations sur les fonctionnalités de traduction.
Si vous souhaitez mettre à jour les traductions après le lancement d’un Canvas, vous devrez d’abord enregistrer votre message en tant que brouillon.

This endpoint est actuellement en accès anticipé. Contactez votre gestionnaire de compte Braze si vous souhaitez participer à l’accès anticipé.
Conditions préalables
Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation canvas.translations.update.
Limite de débit
Cet endpoint a une limite de débit de 250 000 requêtes par minute.
Paramètres de chemin
Cet endpoint n’a pas de paramètres de chemin.
Paramètres de requête
| Paramètre | Requis | Type de données | Description |
|---|---|---|---|
workflow_id |
Requis | Chaîne de caractères | L’ID du Canvas. |
step_id |
Requis | Chaîne de caractères | L’ID de votre étape du Canvas. |
message_variation_id |
Requis | Chaîne de caractères | L’ID de la variation de votre message. |
locale_id |
Requis | Chaîne de caractères | L’ID (UUID) de la locale. |
translation_map |
Requis | Objet | Objet contenant les nouvelles traductions. |

Tous les ID de traduction sont considérés comme des identifiants uniques universels (UUID), qui peuvent être trouvés dans la réponse de l’endpoint GET.
Exemple de requête
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"
}
}
Réponse
Il existe quatre codes de statut de réponse pour cet endpoint : 200, 400, 404 et 429.
Exemple de réponse réussie
1
2
3
{
"message": "success"
}
Exemple de réponse en erreur
Le code de statut 400 pourrait renvoyer le corps de réponse suivant. Consultez la section Résolution des problèmes pour plus d’informations sur les erreurs que vous pourriez rencontrer.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "The provided locale code does not exist."
}
]
}