创建游戏

包含商品本地化名称的对象。值接受以下两种格式之一：两个小写字母的语言代码（例如，en）或五个字符的语言代码（例如，en-US）。虽然两种格式都可作为输入接受，但响应会返回两个小写字母的语言代码。当为同一种语言提供了两种输入时（例如：en和en-US），将存储最后提供的值。您可以在文档中找到支持语言的完整列表。

One of:

两个小写字母的语言代码。

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 商品价格货币。每ISO 4217。请查看文档以获取有关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... 所需时区的限制次数刷新时间（四舍五入到小时）。

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

One of:

两个小写字母的语言代码。

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))

包含本地化商品描述的对象。值接受以下两种格式之一：两个小写字母的语言代码（例如，en）或五个字符的区域设置代码（例如，en-US）。虽然两种格式都可作为输入接受，但响应会返回两个小写字母的语言代码。当为同一种语言提供了两种输入时（例如：en和en-US），将存储最后提供的值。您可以在文档中找到支持语言的完整列表。

One of:

两个小写字母的语言代码。

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))

包含商品详细本地化描述的对象。值接受以下两种格式之一：两个小写字母的语言代码（例如，en）或五个字符的区域设置代码（例如，en-US）。虽然两种格式都可作为输入接受，但响应会返回两个小写字母的语言代码。当为同一种语言提供了两种输入时（例如：en和en-US），将存储最后提供的值。您可以在文档中找到支持语言的完整列表。

Any of:

两个小写字母的语言代码。

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"
}