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

オファーチェーンを作成するServer-sideAdmin

post/v2/project/{project_id}/admin/offer_chain

オファーチェーンを作成します。

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

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

Example: 44056
Request Body schema: application/json
required
(two-letter (object or null)) or (five-letter (object or null))

アイテム名に関するローカライズ用オブジェクト。2文字の小文字の言語コード(例:en)または5文字の言語コード(例:en-US)のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合(例:enen-US)、最後に提供された値が保存されます。サポートされている言語の完全なリストは、ドキュメントで確認できます。

One of:

2文字の小文字の言語コード。

ar
string or null

アラビア語

bg
string or null

ブルガリア語

cn
string or null

中国語(簡体字)

cs
string or null

チェコ語

de
string or null

ドイツ語

en
string or null

英語

es
string or null

スペイン語(スペイン)

fr
string or null

フランス語

he
string or null

ヘブライ語

id
string or null

インドネシア語

it
string or null

イタリア語

ja
string or null

日本語

km
string or null

クメール語

ko
string or null

韓国語

lo
string or null

ラオス語

my
string or null

ビルマ語

ne
string or null

ネパール語

ph
string or null

フィリピン語

pl
string or null

ポーランド語

pt
string or null

ポルトガル語

ro
string or null

ルーマニア語

ru
string or null

ロシア語

th
string or null

タイ語

tr
string or null

トルコ語

tw
string or null

中国語(繁体字)

vi
string or null

ベトナム語

date_start
required
string <date-time>

オファーチェーンの開始日。

required
Array of objects
Array
step_number
required
integer >= 1

ステップ番号。

is_free
required
boolean

オファーチェーンのステップが無料であるかどうかを示します:

required
Array of objects non-empty
Array (non-empty)
sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$

一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。

quantity
required
integer >= 1

このチェーンステップの報酬アイテム数量。

order
integer or null >= 0

オファーチェーンステップの報酬注文。

is_enabled
required
boolean
date_end
string or null <date-time>

オファーチェーンの終了日です。nullも可能です。もしdate_endnullの場合、オファーチェーンには期限が設定されません。

(two-letter (object or null)) or (five-letter (object or null))

アイテムの説明に関するローカライズ用オブジェクト。2文字の小文字の言語コード(例:en)または5文字のロケールコード(例:en-US)のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合(例:enen-US)、最後に提供された値が保存されます。サポートされている言語の完全なリストは、ドキュメントで確認できます。

One of:

2文字の小文字の言語コード。

ar
string or null

アラビア語

bg
string or null

ブルガリア語

cn
string or null

中国語(簡体字)

cs
string or null

チェコ語

de
string or null

ドイツ語

en
string or null

英語

es
string or null

スペイン語(スペイン)

fr
string or null

フランス語

he
string or null

ヘブライ語

id
string or null

インドネシア語

it
string or null

イタリア語

ja
string or null

日本語

km
string or null

クメール語

ko
string or null

韓国語

lo
string or null

ラオス語

my
string or null

ビルマ語

ne
string or null

ネパール語

ph
string or null

フィリピン語

pl
string or null

ポーランド語

pt
string or null

ポルトガル語

ro
string or null

ルーマニア語

ru
string or null

ロシア語

th
string or null

タイ語

tr
string or null

トルコ語

tw
string or null

中国語(繁体字)

vi
string or null

ベトナム語

order
integer

配列順序を定義します。

(interval_type = 週次 (object or null)) or (interval_type = 月次 (object or null))

オファーチェーンのリセット期間。

One of:

オファーチェーンの週次リセット。

interval_type
required
string

オファーチェーンのリセット頻度。

Value: "weekly"
time
required
string((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1...

オファーチェーンがリセットされる、指定されたタイムゾーンでの時間(時間に丸められます)。

例えば、リセット時間がクアラルンプールタイムゾーン(GMT+8)の01:00に設定されている場合、timeパラメータの値は01:00:00+08:00となります。

day_of_week
required
integer [ 1 .. 7 ]

オファーチェーンがリセットされる曜日。1は月曜日、7は日曜日。

Responses
201

オファーチェーンが正常に作成されました。

401

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

422

オファーチェーンの設定が無効です。

Request samples
application/json
{
  • "date_end": null,
  • "date_start": "2023-04-15T18:16:00+05:00",
  • "description": {
    },
  • "is_enabled": true,
  • "name": {
    },
  • "order": 4,
  • "recurrent_schedule": null,
  • "steps": [
    ]
}
Response samples
application/json
{
  • "offer_chain_id": 10
}