캠페인에 대한 번역 보기
get
/campaign/translations/?locale_id={locale_id}
이 엔드포인트를 사용하여 번역된 캠페인 메시지를 보고 이 메시지가 사용자에게 어떻게 보이는지 확인합니다.
important:
API를 통해 번역된 캠페인 메시지를 보는 것은 현재 얼리 액세스 중입니다. 얼리 액세스 참여에 관심이 있는 경우 Braze 계정 매니저에게 문의하세요.
필수 구성 요소
이 엔드포인트를 사용하려면 campaigns.translations.get
권한이 있는 API 키가 필요합니다.
사용량 제한
이 엔드포인트의 사용량 제한은 시간당 250,000건의 요청입니다.
경로 매개변수
매개변수 | 필수 | 데이터 유형 | 설명 |
---|---|---|---|
campaign_id |
필수 | 문자열 | 캠페인의 ID입니다. |
message_variation_id |
필수 | 문자열 | 메시지 변형을 위한 ID입니다. |
locale_id |
필수 | 문자열 | 로캘의 ID입니다. |
모든 번역 ID는 다국어 지원 설정이나 요청 응답에서 찾을 수 있는 UUID(범용 고유 식별자)로 간주된다는 점에 유의하세요.
요청 예시
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/campaign/translations/?locale_id={locale_id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
응답
이 엔드포인트에 대한 상태 코드 응답은 200
, 400
, 404
, 429
등 네 가지가 있습니다.
성공 응답의 예
200
상태 코드는 다음과 같은 응답 헤더와 본문을 반환할 수 있습니다.
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": "es-MX",
"country": "Mexico",
"language": "Spanish",
},
"translation_map": {
"id_0": "Hello",
"id_1": "My name is Jacky",
"id_2": "Where is the library?"
}
}
]
}
오류 응답의 예
400
상태 코드는 다음과 같은 응답 본문을 반환할 수 있습니다. 발생할 수 있는 오류에 대한 자세한 내용은 문제 해결을 참조하세요.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "Invalid locale ID"
}
]
}
문제 해결
다음 표에는 반환될 수 있는 오류와 관련 문제 해결 단계가 나와 있습니다.
오류 메시지 | 문제 해결 |
---|---|
INVALID_CAMPAIGN_ID |
캠페인 ID가 번역 중인 캠페인과 일치하는지 확인합니다. |
INVALID_LOCALE_ID |
메시지 번역에 로캘 ID가 있는지 확인합니다. |
INVALID_MESSAGE_VARIATION_ID |
메시지 ID가 올바른지 확인합니다. |
MESSAGE_NOT_FOUND |
번역할 메시지를 확인합니다. |
LOCALE_NOT_FOUND |
다국어 설정에 로캘이 있는지 확인합니다. |
MULTI_LANGUAGE_NOT_ENABLED |
작업 공간에 대한 다국어 설정이 켜져 있지 않습니다. |
MULTI_LANGUAGE_NOT_ENABLED_ON_MESSAGE |
이메일 캠페인 또는 이메일이 포함된 캔버스 메시지만 번역할 수 있습니다. |
UNSUPPORTED_CHANNEL |
이메일 캠페인의 메시지 또는 이메일이 포함된 캔버스 메시지만 번역할 수 있습니다. |
New Stuff!