Skip to content

キャンバス内の翻訳を更新

put

/canvas/translations

このエンドポイントを使用して、キャンバスの複数の翻訳を更新します。

前提条件

このエンドポイントを使用するには、API キーcanvas.translations.updateの権限が必要です。

レート制限

このエンドポイントには、1時間あたり250,000リクエストのレート制限があります。

パスパラメータ

このエンドポイントにはパスパラメータがありません。

リクエストパラメーター

パラメータ required データ型 説明
locale_id 必須 string ロケールのID。

例のリクエスト

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!