Mise à jour de la traduction dans un canvas
/canvas/translations
Utilisez cet endpoint pour mettre à jour plusieurs traductions pour un Canvas. Pour plus d’informations sur les fonctionnalités de traduction, reportez-vous à la section Locales dans les messages.
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.
Cet 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
Le débit de cet endpoint est limité à 250 000 requêtes par minute.
Paramètres de chemin
Cet endpoint n’a pas de chemin de paramètres.
Paramètres de demande
| Paramètre | Requis | Type de données | Description |
|---|---|---|---|
workflow_id |
Requis | Chaîne de caractères | L’ID de la toile. |
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 demande
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
Quatre réponses de code de statut existent pour cet endpoint : 200, 400, 404 et 429.
Exemple de réponse réussie
1
2
3
{
"message": "success"
}
Exemple de réponse échouée
Le code de statut 400 pourrait renvoyer le corps de réponse suivant. Consultez la résolution des problèmes pour plus d’informations concernant les erreurs que vous pourriez rencontrer.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "The provided locale code does not exist."
}
]
}
Modifier cette page sur GitHub