ユニークカタログオファープロモーションをアップデート

または

パブリッシャーアカウントへ

ユニークカタログオファープロモーションをアップデートServer-sideAdmin

put/v3/project/{project_id}/admin/unique_catalog_offer/{external_id}

ユニークカタログオファープロモーションをアップデート

SecuritybasicAuth

Request

path Parameters

project_id required	integer プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。 Example: 44056
external_id required	integer プロモーションexternal ID。プロジェクト内での一意のプロモーション識別子。 Example: coupon_44056_1

Request Body schema: application/json

required

object

Default: {"de-DE":"Gutscheintitel","en-US":"Coupon title"}

プロモーションの名前。キーと値のペアを含む必要があります。キーは"^[a-z]{2}-[A-Z]{2}$"形式のロケール、値は文字列です。

property name*

additional property

string

items

Array of strings

ユニークカタログオファー使用後に利用可能なアイテムSKUリスト。

Array of objects

プロモーションの有効期間。複数の期間を指定する場合は、date_fromとdate_untilの両方が必須となります。

Array

date_from required	string <date-time> 指定されたプロモーションの開始日。
date_until	string or null <date-time> 指定されたプロモーションの終了日。`null`に設定した場合、プロモーションは無期限となります。単一の有効期間のみが指定されている場合に限り、`null`に設定可能です。

redeem_code_limit

integer or null

Default: 10

コードごとの引き換え回数。

redeem_total_limit

integer or null

Default: 10

クーポンの総数を制限します。

redeem_user_limit

integer or null

Default: 10

一人のユーザーが引き換えできるクーポンの総数を制限します。

Responses

204

ユニークカタログオファーは正常にアップデートされました。

401

基本認証が不合格または不正です。基本認証または正しい認証情報を使用したことを確認してください。

404

クーポンが見つかりません。external_idが正しいことを確認してください。

422

無効なリクエストです。

Request samples

application/json

{"items": ["elven_sword",
"elven_boots"
],
"name": {"de-DE": "Neujahrsangebot",
"en-US": "New Year Offer"
},
"promotion_periods": [{"date_from": "2020-04-15T18:16:00+05:00",
"date_until": "2020-04-25T18:16:00+05:00"
}
],
"redeem_code_limit": 1,
"redeem_total_limit": 100,
"redeem_user_limit": 1
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}