Xsolla-logo

ゲームを作成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
object

アイテム名のローカライズを行ったオブジェクトです。小文字の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
it
string or null
ja
string or null
ko
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 = weekly (object) or interval_type = monthly (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...

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

object

アイテム名のローカライズを行ったオブジェクトです。小文字の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
it
string or null
ja
string or null
ko
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
id
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
object

アイテムの説明用のローカライズされたオブジェクト。小文字の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
it
string or null
ja
string or null
ko
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

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

object

アイテムの長い説明のためのローカライゼーションを持つオブジェクト。小文字の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
it
string or null
ja
string or null
ko
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": {
    },
  • "groups": [
    ],
  • "image_url": "http://image.png",
  • "is_enabled": true,
  • "is_show_in_store": true,
  • "long_description": {
    },
  • "media_list": [],
  • "name": {
    },
  • "sku": "game_1",
  • "unit_items": [
    ]
}
Response samples
application/json
{
  • "item_id": 101,
  • "sku": "game_1"
}
System statusAll services operational

Privacy Settings

Privacy PolicyEnd User License Agreement© 2006–2024 Xsolla Inc.