# プロモーションコードのプロモーションを更新 プロモーションコードのプロモーションを更新しました。 Endpoint: PUT /v3/project/{project_id}/admin/promocode/{external_id} Version: 2.0.0 Security: basicAuth ## Path parameters: - `project_id` (integer, required) プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。 Example: 44056 - `external_id` (integer, required) プロモーションexternal ID。プロジェクト内での一意のプロモーション識別子。 Example: "coupon_44056_1" ## Request fields (application/json): - `attribute_conditions` (array) ユーザー属性を検証するための条件。 ユーザー属性が指定されたすべての条件に一致するかどうかに基づいて、プロモーションの可用性を決定します。 - `bonus` (array,null) - `bonus.quantity` (number) アイテム数量。 - `bonus.sku` (string) アイテムSKU。 - `discount` (object,null) Example: {"percent":"10.10"} - `discount.percent` (string,null) 割引率。 カートの価格は、この割引率で計算された値で減少し、小数点以下2桁に四捨五入されます。 Example: "10.00" - `discounted_items` (array,null) プロモーションコードによる割引が適用されるアイテムリスト。 - `excluded_promotions` (array) このプロモーションを適用する際に除外するプロモーションIDのリスト。Example:[12, 789] Example: [12,789] - `item_price_conditions` (array,null) カートの中の特定のアイテムにプロモーションを適用するための価格範囲を設定する条件を持つオブジェクトの配列。 ユーザーのカート内の各アイテムの価格は、条件で指定された価格帯と比較されます。[ボーナス](/ja/api/shop-builder/operation/create-promo-code/#!path=bonus&t=request)と[ディスカウント](/ja/api/shop-builder/operation/create-promo-code/#!path=discount&t=request)は、カート内のアイテムのうち、価格が条件を満たすものにのみ適用されます。 この配列を渡す場合は、[discounted_items](/ja/api/shop-builder/operation/create-promo-code/#!path=discounted_items&t=request)配列の値をnullに設定します。 - `item_price_conditions.operator` (string, required) プロモーションを適用する価格帯を設定する比較演算子。 Enum: "ge", "gt", "le", "lt", "eq", "ne" - `item_price_conditions.value` (string, required) プロモーションを適用する価格帯を決定するための値。 - `name` (object, required) プロモーションの名前。キーと値のペアを含む必要があります。 キーは"^[a-z]{2}-[A-Z]{2}$"形式のロケール、値は文字列です。 Example: {"de-DE":"Gutscheintitel","en-US":"Coupon title"} - `price_conditions` (array,null) カート全体にプロモーションを適用するための価格帯を設定する条件を持つオブジェクトの配列。 ユーザーのカート内の全アイテムの合計価格が、条件で指定された価格範囲と比較されます。[ボーナス](/ja/api/shop-builder/operation/create-promo-code/#!path=bonus&t=request)と[割引](/ja/api/shop-builder/operation/create-promo-code/#!path=discount&t=request)は、カートの価格が指定された条件を満たす場合に、カート内のすべてのアイテムに適用されます。 この配列を渡す場合は、[discounted_items](/ja/api/shop-builder/operation/create-promo-code/#!path=discounted_items&t=request) 配列の値をnullに設定します。 - `promotion_periods` (array) プロモーションの有効期間。複数の期間を指定する場合は、date_fromとdate_untilの両方が必須となります。 - `promotion_periods.date_from` (string, required) 指定されたプロモーションの開始日。 Example: "2020-08-11T10:00:00+03:00" - `promotion_periods.date_until` (string,null) 指定されたプロモーションの終了日。nullに設定した場合、プロモーションは無期限となります。単一の有効期間のみが指定されている場合に限り、nullに設定可能です。 Example: "2020-08-11T20:00:00+03:00" - `redeem_code_limit` (integer,null) コードごとの引き換え回数。 Example: 10 - `redeem_total_limit` (integer,null) クーポンの総数を制限します。 Example: 10 - `redeem_user_limit` (integer,null) 一人のユーザーが引き換えできるクーポンの総数を制限します。 Example: 10 ## Response 401 fields (application/json): - `errorCode` (integer) Example: 1020 - `errorMessage` (string) Example: "[0401-1020]: Error in Authentication method occurred" - `statusCode` (integer) Example: 401 ## Response 404 fields (application/json): - `errorCode` (integer) Example: 4001 - `errorMessage` (string) Example: "[0401-9802]: Promocode not found" - `statusCode` (integer) Example: 404 - `transactionId` (string) Example: "x-x-x-x-transactionId-mock-x-x-x" ## Response 422 fields (application/json): - `errorCode` (integer) Example: 1102 - `errorMessage` (string) Example: "[0401-1102]: Unprocessable Entity. The property `external_id` is required" - `statusCode` (integer) Example: 422 ## Response 204 fields