Xsolla-logo
または
パブリッシャーアカウントへ

アイテムの割引プロモーションを作成Server-sideAdmin

post/v3/project/{project_id}/admin/promotion/item

アイテムの割引キャンペーンを作成します。

キャンペーンは、アイテムの割引（％）を提供します。 指定したアイテムの全価格に割引が適用されます。

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。

Example: 44056
Request Body schema: application/json

プロモーションデータを持つオブジェクト。

required
Array of objects
Array
sku
required
string
Default: "elven_sword"

アイテムSKU。

required
object
percent
required
string

割引率。 アイテムの価格は、この割引率で計算された値で減少し、小数点以下2桁に四捨五入されます。

required
object

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

property name*
additional property
string
Array of type = string (object) or type = number (object) or type = date (object) [ 1 .. 100 ] items

ユーザー属性を検証するための条件。 ユーザー属性が指定されたすべての条件に一致するかどうかに基づいて、プロモーションの可用性を決定します。

Array ([ 1 .. 100 ] items)
One of:
attribute
required
string [ 1 .. 255 ] characters ^[-_.\d\w]+$

ユーザー属性コード。

operator
required
string

条件によって実行される操作のタイプ。string属性タイプの場合。

Enum: Description
eq

イコール

ne

ノットイコール

value
required
string <= 255 characters

ユーザー属性値の比較対象となる条件値。ライプは属性タイプに依存します。

type
required
string

ユーザー属性タイプ。

Value: "string"
can_be_missing
boolean

ユーザー属性に属性がない場合でも条件を満たすことを示します。trueを渡すと、この属性を持たないユーザーにもアイテムを表示します。属性は持っているが、値が条件で指定されたものと一致しないユーザーには、アイテムは表示されません。false - その属性を持っているが、値が条件に指定されたものと一致しないか、属性が欠落しているユーザーには、アイテムは表示されません。

excluded_promotions
Array of integers

このプロモーションを適用する際に除外するプロモーションIDのリスト。
Example：[12, 789]

is_enabled
boolean

プロモーションが有効かどうか。

object

プロモーションの制限。

per_user
integer or null

別ユーザーでのプロモーション制限。

object or null

制限更新期間。

object

ユーザー制限更新期間。

day_of_month
integer or null [ 1 .. 31 ]

制限が更新される月の日。月の残り時間が短いために選択された日がない場合、更新はその月の最終日に行われます。monthly制限更新期間タイプはnullのみではありません。

day_of_week
integer or null [ 1 .. 7 ]

制限が更新される曜日。1は月曜日、7は日曜日です。weekly制限更新期間タイプはnullのみではありません。

displayable_reset_next_date
string <date-time>

制限をリセットする日時（ISO 8601）。

displayable_reset_start_date
string <date-time>

最初の制限更新の日時（ISO 8601）。

interval_type
string

定期更新期間のタイプ。

Enum: "daily" "weekly" "monthly"
reset_next_date
integer

制限が更新された日時（UNIXタイムスタンプ）。

time
string <full-time>

希望するタイムゾーンでのリミットの更新時刻（時間単位で四捨五入）。

Array of objects or null

プロモーションを適用する価格帯を設定する条件を持つオブジェクトの配列。
プロモーションは、価格が配列内のすべての条件を満たすアイテムにのみ適用されます。この配列を渡す場合は、アイテムオブジェクトの値をnullに設定します。

Array
operator
required
string

プロモーションを適用する価格帯を設定する比較演算子。

Enum: Description
eq

イコール

ge

大なりイコール

gt

より大きい

le

小なりイコール

lt

より小さい

ne

ノットイコール

value
required
string^\d+(\.\d{1,4})?$

プロモーションを適用する価格帯を決定するための値。

Array of objects

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

Array
date_from
required
string <date-time>

指定されたプロモーションの開始日。

date_until
string or null <date-time>

指定されたプロモーションの終了日。nullに設定した場合、プロモーションは無期限となります。単一の有効期間のみが指定されている場合に限り、nullに設定可能です。

Responses
201

プロモーションは正常に作成されました。

401

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

422

無効なリクエストです。

Request samples
application/json
{
  • "attribute_conditions": [
    ],
  • "discount": {
    },
  • "is_enabled": true,
  • "items": [ ],
  • "name": {
    },
  • "promotion_periods": [
    ]
}
Response samples
application/json
{
  • "promotion_id": 2384756
}

Privacy Settings

Privacy PolicyEnd User License Agreement
System statusAll services operational
© 2006–2026 Xsolla Inc.