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. Veuillez consulter la section Locales dans les messages pour plus d’informations sur les fonctionnalités de traduction.

important:

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

Ce endpoint est soumis à une limite de débit de 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 Lorsquetrue renvoie la dernière version préliminaire au lieu de la dernière version publiée en ligne/en production/instantanée. Par défaut, la dernière version falseinstantanée en ligne est renvoyé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!