ゲームを作成

Xsolla Developers

または

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

ゲームを作成Server-sideAdmin

post/v2/project/{project_id}/admin/items/game

プロジェクト内のゲームを作成します。

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。

Example: 44056

Request Body schema: application/json

ゲームデータを持つオブジェクト。

sku

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

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

required

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

アイテム名に関するローカライズ用オブジェクト。2文字の小文字の言語コード（例：en）または5文字の言語コード（例：en-US）のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合（例：enとen-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 ベトナム語

required

Array of objects

異なるDRMに対応したゲームキー。

Array

sku

required

string [ 1 .. 255 ] characters

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

drm_sku

required

string

DRMユニークID。

required

Array of objects

実際通貨建ての価格。

Array

amount required	number
currency required	string 商品価格の通貨。3文字のコードISO4217 規格詳細については、ドキュメントを参照してください。Xsollaでサポートされている通貨。
is_default required	boolean ユーザーの通貨での価格が指定されていない場合、デフォルトの価格がカタログ作成に使用されます。
is_enabled required	boolean

Array of objects

属性リスト。

Array

external_id

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

一意の属性ID。external_idには、小文字と大文字のラテン英数字、ダッシュ、およびアンダースコアのみが含まれます。

required

Array of objects

Array

required

object

Default: {"de":"Strategie","en":"Strategy"}

値名がローカライズされたオブジェクト。キーはISO 3166-1で指定されています。

property name*

additional property

string

external_id

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

属性の一意の値ID。external_idには、英小文字、ダッシュ、およびアンダースコアのみが含まれます。

object

Default: {"de":"Genre","en":"Genre"}

属性用のローカライズされたオブジェクト。キーはISO 3166-1で指定されています。

property name*

additional property

string

Array of objects

アイテムが所属するグループ。

Array

external_id

required

string

is_enabled

boolean

無効の場合、アイテムの購入やインベントリからのアクセスはできません。

is_free

boolean

Default: false

trueの場合で、アイテムは無料です。

is_show_in_store

boolean

アイテムは購入可能です。

object

アイテム制限。

per_item

integer or null

グローバルアイテム制限。

per_user

integer or null

別ユーザーのアイテム制限。

object or null

制限更新期間。

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

One of:

ユーザー制限の日次更新タイプ。

interval_type required	string 循環更新期間。 Value: "daily"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... 希望するタイムゾーンでのリミットの更新時刻（時間単位で四捨五入）。

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

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

リスト内のゲーム順の優先順位。

Array of objects or null

アイテム販売期間。

Array

date_from	string <date-time> 指定されたアイテムの販売開始日。
date_until	string or null <date-time> 指定されたアイテムが販売できなくなる日付。`null`を指定することもできます。

object

先行予約の設定。

release_date required	string ISO 8601形式でのゲームキーのリリース日。
is_enabled required	boolean 無効の場合、アイテムは先行予約ではありません。
description	string 予約注文に関する追加情報は電子メールで送信されます。

Array of objects

Array

integer

Array of objects

Array

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

Array of objects <= 20 items

属性のリスト。

注意。アイテムの属性は20個以上指定することはできません。制限を超えようとすると、エラーが発生します。

Array (<= 20 items)

external_id

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

一意の属性ID。external_idには、小文字と大文字のラテン英数字、ダッシュ、およびアンダースコアのみが含まれます。

required

Array of objects

注意。各属性に6つ以上の値を作成することはできません。制限を超えようとすると、エラーが発生します。

Array

required

object

Default: {"de":"Strategie","en":"Strategy"}

値名がローカライズされたオブジェクト。キーはISO 3166-1で指定されています。

property name*

additional property

string

external_id

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

属性の一意の値ID。external_idには、英小文字、ダッシュ、およびアンダースコアのみが含まれます。

object

Default: {"de":"Genre","en":"Genre"}

属性用のローカライズされたオブジェクト。キーはISO 3166-1で指定されています。

property name*

additional property

string

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

アイテムの説明に関するローカライズ用オブジェクト。2文字の小文字の言語コード（例：en）または5文字のロケールコード（例：en-US）のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合（例：enとen-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 ベトナム語

Array of objects

アイテムが所属するグループ。

Array

external_id

required

string

image_url

string

画像URL。

is_enabled

boolean

無効の場合、アイテムの購入やインベントリからのアクセスはできません。

is_show_in_store

boolean

アイテムは購入可能です。

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

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

Any 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 ベトナム語

Array of objects

スクリーンショット、ゲームプレイ動画などのゲーム追加アセット。

Array

type	string メディアタイプ：`image`/`video`。 Enum: "image" "video"
url	string リソースファイル。

order

integer

リスト内のゲーム順の優先順位。

Responses

201

ゲームが正常に作成されました。

401

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

422

無効なリクエストです。

Request samples

application/json

{"description": {"en-US": "Game description",
"ru-RU": "Краткое описание игры"
},
"groups": ["new_games"
],
"image_url": "http://image.png",
"is_enabled": true,
"is_show_in_store": true,
"long_description": {"en-US": "Game long description",
"ru-RU": "Полное описание игры"
},
"media_list": [{"type": "image",
"url": "http://image.png"
},
{"type": "video",
"url": "http://video.png"
}
],
"name": {"en-US": "Game name",
"ru-RU": "Название игры"
},
"sku": "com.xsolla.game_1",
"unit_items": [{"drm_sku": "steam_key_1",
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {"per_item": {"available": 5000,
"reserved": 500,
"sold": 4500,
"total": 10000
},
"per_user": {"total": 5
}
},
"name": {"en-US": "Game key name",
"ru-RU": "Название игрового ключа"
},
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"pre_order": {"description": "Some description",
"is_enabled": true,
"release_date": "2020-08-11T10:00:00+03:00"
},
"prices": [{"amount": 35.5,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"regions": [{"id": 12
},
{"id": 64
}
],
"sku": "com.xsolla.game_key_1",
"vc_prices": [{"amount": 35.5,
"is_default": true,
"is_enabled": true,
"sku": "com.xsolla.gold_1"
}
]
}
]
}

Response samples

application/json

{"item_id": 101,
"sku": "com.xsolla.game_1"
}