Voir toutes les traductions pour une campagne

get

/campagnes/traductions

Utilisez ce point de terminaison pour voir toutes les traductions de chaque variante de message dans une campagne. Pour plus d’informations sur les fonctionnalités de traduction, reportez-vous à la section Locales dans les messages.

important:

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 campaigns.translations.get.

Limite de débit

Le débit de cet endpoint est limité à 250 000 requêtes par minute.

Paramètres de recherche

Paramètre Requis Type de données Description

campaign_id Requis Chaîne de caractères L’ID de votre campagne.

message_variation_id Requis Chaîne de caractères L’ID de la variation de votre message.

locale_id Facultatif Chaîne de caractères Un UUID local pour filtrer les réponses.

post_launch_draft_version Facultatif Valeur booléenne Lorsque true renvoie la dernière version provisoire au lieu de la dernière version publiée en ligne/instantanée. La valeur par défaut est false, qui renvoie la dernière version en ligne/en production/instantanée.

note:

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

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

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.

{
    "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 échouée

Le code de statut 400 pourrait renvoyer le corps de réponse suivant.

{
	"errors": [
		{
			"message": "This message does not support multi-language."
		}
	]
}

Modifier cette page sur GitHub

New Stuff!