이메일 템플릿 엔드포인트의 특정 번역 및 로캘 보기
get
/templates/translations/email?locale_id={locale_uuid}&template_id={template_id}
이 엔드포인트를 사용하여 이메일 템플릿의 이메일 템플릿 엔드포인트에 대한 특정 번역 및 로캘을 확인하세요.
important:
이 엔드포인트는 현재 얼리 액세스 중입니다. Contact your Braze account manager if you’re interested in participating in the early access.
필수 조건
이 엔드포인트를 사용하려면 templates.translations.get
권한이 있는 API 키가 필요합니다.
사용량 제한
쿼리 매개변수
매개변수 | 필수 | 데이터 유형 | 설명 |
---|---|---|---|
template_id |
필수 | 문자열 | 이메일 템플릿의 ID입니다. |
locale_id |
필수 | 문자열 | 로캘의 ID입니다. |
모든 번역 ID는 다국어 지원 설정이나 요청 응답에서 찾을 수 있는 UUID(범용 고유 식별자)로 간주된다는 점에 유의하세요.
예시 요청
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/templates/translations/email?locale_id={locale_uuid}&template_id={template_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
19
20
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"translations": [
{
"locale": {
"uuid": "c7c12345-te35-1234-5678-abcdefa99r3f",
"name": "es-MX",
"country": "MX",
"language": "es",
"locale_key": "es-mx"
},
"translation_map": {
"id_0": "¡Hola!",
"id_1": "Me llamo Jacky",
"id_2": "¿Dónde está la biblioteca?"
}
}
]
}
오류 응답의 예
400
상태 코드는 다음과 같은 응답 본문을 반환할 수 있습니다. 발생할 수 있는 오류에 대한 자세한 내용은 문제 해결을 참조하세요.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "The provided locale code does not exist."
}
]
}
문제 해결
다음 표에는 반환될 수 있는 오류와 관련 문제 해결 단계가 나와 있습니다.
오류 메시지 | 문제 해결 |
---|---|
INVALID_LOCALE_ID |
메시지 번역에 로캘 ID가 있는지 확인합니다. |
LOCALE_NOT_FOUND |
다국어 설정에 로캘이 있는지 확인합니다. |
MULTI_LANGUAGE_NOT_ENABLED |
작업 공간에 대한 다국어 설정이 켜져 있지 않습니다. |
MULTI_LANGUAGE_NOT_ENABLED_ON_MESSAGE |
이메일 템플릿과 이메일, 푸시, 인앱 메시지 캠페인 또는 이메일이 포함된 캔버스 메시지만 번역할 수 있습니다. |
New Stuff!