캔버스에서 번역 업데이트
put
/canvas/translations
이 엔드포인트를 사용하여 캔버스에 대한 여러 번역을 업데이트할 수 있습니다.
important:
API를 통해 캔버스 메시지의 번역을 업데이트하는 기능은 현재 얼리 액세스 중입니다. 얼리 액세스에 참여하려면 Braze 계정 매니저에게 문의하세요.
필수 구성 요소
이 엔드포인트를 사용하려면 canvas.translations.update
권한이 있는 API 키가 필요합니다.
사용량 제한
이 엔드포인트의 사용량 제한은 시간당 250,000건의 요청입니다.
경로 매개변수
이 엔드포인트에는 경로 매개 변수가 없습니다.
요청 매개변수
매개변수 | 필수 | 데이터 유형 | 설명 |
---|---|---|---|
step_id |
필수 | 문자열 | 캔버스 단계의 ID입니다. |
message_variation_id |
필수 | 문자열 | 메시지의 ID입니다. |
locale_id |
필수 | 문자열 | 로캘의 ID입니다. |
모든 번역 ID는 다국어 지원 설정이나 GET 요청 응답에서 찾을 수 있는 UUID(범용 고유 식별자)로 간주된다는 점에 유의하세요.
요청 예시
1
2
3
4
5
6
7
8
9
10
11
12
13
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"canvas_id": "9a0ba932-11c0-4c33-b529-e79aafc12409",
"message_variation_id": "f5896eec-847d-4c0d-a4b6-7695e67520d7",
"locale_id": "3fa10d31-83ae-4ff4-9631-f52cea9ec8fa",
"translation_map": {
"id_4": "¿Dónde está la biblioteca? Me llamo T-Bone, La araña discoteca.",
"subject_1": "¿Dónde está la biblioteca? Me llamo T-Bone, La araña discoteca.",
"id_1": "¿Dónde está la biblioteca? Me llamo T-Bone, La araña discoteca.",
"image": "¿Dónde está la biblioteca? Me llamo T-Bone, La araña discoteca."
}
}
성공 응답의 예
1
2
3
{
"message": "success"
}
오류 응답의 예
400
상태 코드는 다음과 같은 응답 본문을 반환할 수 있습니다. 발생할 수 있는 오류에 대한 자세한 내용은 문제 해결을 참조하세요.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "Something went wrong. Translation IDs are mismatched or translated text exceeds limits."
}
]
}
문제 해결
다음 표에는 반환될 수 있는 오류와 관련 문제 해결 단계가 나와 있습니다.
오류 메시지 | 문제 해결 |
---|---|
INVALID_CAMPAIGN_ID |
캠페인 ID가 번역 중인 캠페인과 일치하는지 확인합니다. |
INVALID_LOCALE_ID |
메시지 번역에 로캘 ID가 있는지 확인합니다. |
INVALID_MESSAGE_VARIATION_ID |
메시지 ID가 올바른지 확인합니다. |
INVALID_TRANSLATION_OBJECT |
번역 ID가 일치하지 않거나 번역된 텍스트가 한도를 초과합니다. |
MESSAGE_NOT_FOUND |
번역할 메시지를 확인합니다. |
LOCALE_NOT_FOUND |
다국어 설정에 로캘이 있는지 확인합니다. |
MISSING_TRANSLATIONS |
번역 ID는 메시지와 일치해야 합니다. |
MULTI_LANGUAGE_NOT_ENABLED |
작업 공간에 대한 다국어 설정이 켜져 있지 않습니다. |
MULTI_LANGUAGE_NOT_ENABLED_ON_MESSAGE |
이메일 캠페인 또는 이메일이 포함된 캔버스 메시지만 번역할 수 있습니다. |
UNSUPPORTED_CHANNEL |
이메일 캠페인의 메시지 또는 이메일이 포함된 캔버스 메시지만 번역할 수 있습니다. |
1
2
3
4
5
6
7
8
9
10
INVALID_CAMPAIGN_ID = "Invalid campaign or step ID"
INVALID_LOCALE_ID = "Invalid locale ID"
INVALID_MESSAGE_VARIATION_ID = "Invalid message ID"
INVALID_TRANSLATION_OBJECT = "Invalid translation object"
MESSAGE_NOT_FOUND = "Message not found"
LOCALE_NOT_FOUND = "Locale not found"
MISSING_TRANSLATIONS = "Missing translations from the request body"
MULTI_LANGUAGE_NOT_ENABLED = "Multi-language feature is not enabled on this company"
MULTI_LANGUAGE_NOT_ENABLED_ON_MESSAGE = "This message does not have multi-language setup"
UNSUPPORTED_CHANNEL = "This message type does not support multi-language"
New Stuff!