Skip to content

Alle Übersetzungen für eine Campaign anzeigen

get

/campaigns/translations

Verwenden Sie diesen Endpunkt, um alle Übersetzungen für jede Nachrichtenvariante in einer Campaign anzuzeigen. Weitere Informationen zu den Übersetzungsfeatures finden Sie unter Locales in Nachrichten.

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung campaigns.translations.get.

Rate-Limit

Dieser Endpunkt hat ein Rate-Limit von 250.000 Anfragen pro Minute.

Abfrageparameter

Parameter Erforderlich Datentyp Beschreibung
campaign_id Erforderlich String Die ID Ihrer Campaign.
message_variation_id Erforderlich String Die ID Ihrer Nachrichtenvariante.
locale_id Optional String Eine Locale-UUID zum Filtern der Antworten.
post_launch_draft_version Optional Boolescher Wert Bei true wird die neueste Entwurfsversion anstelle der zuletzt veröffentlichten Live-Version zurückgegeben. Standardmäßig false, wodurch die aktuellste Live-Version zurückgegeben wird.

Beispielanfrage

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'

Antwort

Es gibt vier Statuscode-Antworten für diesen Endpunkt: 200, 400, 404 und 429.

Beispiel für eine erfolgreiche Antwort

Der Statuscode 200 könnte den folgenden Antwort-Header und -Body zurückgeben.

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"
            }
        }
    ]
}

Beispiel für eine Fehlerantwort

Der Statuscode 400 könnte den folgenden Antwort-Body zurückgeben.

1
2
3
4
5
6
7

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