Voir toutes les traductions pour une campagne
/campaigns/translations
Utilisez cet endpoint pour voir toutes les traductions de chaque variante de message dans une Campaign. Consultez Locales dans les messages pour en savoir plus sur les fonctionnalités de traduction.
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 campaigns.translations.get.
Limite de débit
Cet endpoint a une limite de débit de 250 000 requêtes par minute.
Paramètres de requête
| Paramètre | Requis | Type de données | Description |
|---|---|---|---|
campaign_id |
Requis | Chaîne de caractères | L’ID de votre Campaign. |
message_variation_id |
Requis | Chaîne de caractères | L’ID de votre variante de message. |
locale_id |
Facultatif | Chaîne de caractères | Un UUID de locale pour filtrer les réponses. |
post_launch_draft_version |
Facultatif | Valeur booléenne | Lorsque la valeur est true, renvoie la dernière version brouillon au lieu de la dernière version publiée en production. La valeur par défaut est false, ce qui renvoie la dernière version en production. |
Tous les ID de traduction sont considérés comme des identifiants uniques universels (UUID), disponibles dans la réponse de l’endpoint GET.
Exemple de requête
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/campaigns/translations?campaign_id={campaign_id}&message_variation_id={message_variation_id}&locale_id={locale_uuid}&post_launch_draft_version=true' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
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
Le code de statut 200 pourrait renvoyer l’en-tête et le corps de réponse suivants.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
"translations": [
{
"translation_map": {
"id_0": "¡Hola!",
"id_1": "Me llamo Jacky",
"id_2": "¿Dónde está la biblioteca?"
},
"locale": {
"uuid": "c7c12345-te35-1234-5678-abcdefa99r3f",
"name": "es-MX",
"country": "MX",
"language": "es",
"locale_key": "es-mx"
}
},
{
"translation_map": {
"id_0": "你好",
"id_1": "我的名字是 Jacky",
"id_2": "圖書館在哪裡?"
},
"locale": {
"uuid": "a1b12345-cd35-1234-5678-abcdefa99r3f",
"name": "zh-HK",
"country": "HK",
"language": "zh",
"locale_key": "zh-hk"
}
}
]
}
Exemple de réponse en erreur
Le code de statut 400 pourrait renvoyer le corps de réponse suivant.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "This message does not support multi-language."
}
]
}