キャンペーン内の翻訳を更新
put
/campaigns/translations
キャンペーンの複数の翻訳を更新するには、このエンドポイントを使用する。
important:
API経由でキャンペーン内の翻訳を更新することは、現在早期アクセス中である。早いアクセスに参加したい場合は、Braze アカウントマネージャーに連絡してください。
前提条件
このエンドポイントを使用するには、API キーとcampaigns.translations.update
の権限が必要です。
レート制限
このエンドポイントには、1時間あたり250,000リクエストというレート制限がある。
パスパラメーター
このエンドポイントにはパスパラメータがありません。
リクエストパラメーター
パラメータ | 必須 | データ型 | 説明 |
---|---|---|---|
campaign_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
{
"campaign_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 |
メールキャンペーン内のメッセージ、またはメールが含まれているキャンバスメッセージのみを翻訳できます。 |
New Stuff!