メールテンプレートの翻訳を更新
put
/templates/email/translations/
メールテンプレートの翻訳を更新するには、このエンドポイントを使用します。
important:
このエンドポイントは現在早期アクセス中である。早期アクセスへの参加に興味がある方は、Brazeのアカウントマネージャーに連絡を。
前提条件
このエンドポイントを使用するには、API キーとtemplates.translations.update
の権限が必要です。
レート制限
パスパラメーター
このエンドポイントにはパスパラメータがありません。
リクエストパラメーター
パラメーター | required | データ型 | 説明 |
---|---|---|---|
template_id |
必須 | string | メールテンプレートの ID。 |
locale_id |
必須 | 文字列 | ロケールのID。 |
translations |
必須 | string | メールテンプレートの翻訳のマップ。 |
すべての翻訳IDは、多言語サポート設定またはGETリクエストレスポンスで見つけることができるユニバーサルユニーク識別子(UUID)とみなされることに注意。
リクエスト例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"template_id": "e24404b3-3626-4de0-bdec-06935f3aa0ab",
"locale_id": "h94404b3-3626-4de0-bdec-06935f3aa0ad",
"translations": [
{
"translation_map": {
"id_0": "¡Hola!",
"id_1": "Me llamo Jacky",
"id_2": "¿Dónde está la biblioteca?"
}
}
]
}
応答
このエンドポイントには、200
、400
、404
、429
という 4 つのステータスコードの応答があります。
成功応答の例
1
2
3
{
"message": "success"
}
エラー応答例
ステータスコード 400
は、次の応答本文を返す可能性があります。遭遇する可能性のあるエラーの詳細については、「トラブルシューティング」を参照のこと。
1
2
3
4
5
6
7
8
{
"errors": [
{
"id": "1234567-abc-123-012345678",
"message": "The provided translations yielded errors when parsing. Please contact Braze for more information."
}
]
}
トラブルシューティング
以下の表は、返される可能性のあるエラーと、それに関連するトラブルシューティングの手順を示したものである。
エラーメッセージ | トラブルシューティング |
---|---|
The provided translations yielded errors when parsing. Please contact Braze for more information. |
サードパーティの翻訳者が、Liquid エラーを発生させる例外を含む翻訳を提供した場合に発生します。Braze サポートにお問い合わせください。 |
The provided translations are missing 'id_1', 'id_2' |
翻訳IDが一致しないか、翻訳されたテキストが制限を超えています。例えば、これはペイロードの形状が翻訳オブジェクトのフィールドを欠いていることを意味します。すべてのメッセージ(多言語イネーブルメントの場合)は、ID が関連づけられた「翻訳ブロック」を特定の数だけ持つ必要があります。提供されたペイロードに ID のいずれかが欠けている場合、これは不完全なオブジェクトとみなされ、エラーとなります。 |
The provided locale code does not exist. |
サードパーティの翻訳者のペイロードに、Braze には存在しないロケールコードが含まれています。 |
The provided translations have exceeded the maximum of 20MB. |
提供されたペイロードがサイズ制限を超えました。 |
You have exceeded the maximum number of requests. Please try again later. |
すべての Braze API にはレート制限が組み込まれており、この認証トークンに割り当てられたレートを超えた場合、このエラーが自動的に返されます。 |
This message does not support multi-language. |
これは、メッセージ ID がまだ多言語メッセージをサポートしていない場合に発生する可能性があります。プッシュ、アプリ内メッセージ、メールのチャネルのメッセージのみを翻訳できます。 |
New Stuff!