Voir les traductions pour une campagne
/campagnes/traductions
Utilisez ce point de terminaison pour voir toutes les traductions de chaque variante de message dans une campagne.
La visualisation des traductions des messages de campagne via l’API 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 campaigns.translations.get
.
Limite de débit
Cet endpoint a une limitation du débit de 250 000 requêtes par jour.
Paramètres de chemin
Paramètre | Requis | Type de données | Description |
---|---|---|---|
campaign_id |
Requis pour traduire une campagne | Chaîne de caractères | L’ID de votre campagne. |
Exemple de demande
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/campaign/translations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Réponse
Quatre réponses de code de statut existent pour cet endpoint : 200
, 400
, 404
et 429
.
Exemple de réponse réussie
Le code de statut 200
pourrait retourner l’en-tête et le corps de réponse suivant.
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?"
}
}
]
}
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": "This message does not support multi-language."
}
]
}
Résolution des problèmes
Le tableau suivant répertorie les erreurs renvoyées possibles et les étapes de résolution des problèmes associées.
Message d’erreur | Résolution des problèmes |
---|---|
INVALID_CAMPAIGN_ID |
Confirmez que l’ID de la campagne correspond à la campagne que vous traduisez. |
INVALID_MESSAGE_VARIATION_ID |
Confirmez que votre identifiant de message est correct. |
MESSAGE_NOT_FOUND |
Vérifiez que le message à traduire. |
MULTI_LANGUAGE_NOT_ENABLED |
Les paramètres multilingues ne sont pas activés pour votre espace de travail. |
MULTI_LANGUAGE_NOT_ENABLED_ON_MESSAGE |
Seules les campagnes par e-mail ou les messages Canvas avec des e-mails peuvent être traduits. |
UNSUPPORTED_CHANNEL |
Seuls les messages dans les campagnes par e-mail ou les messages Canvas avec des e-mails peuvent être traduits. |