更新捆绑包

project_id required	integer 项目ID。您可以在您的发布商帐户项目名称旁边找到。 Example: 44056
sku required	string 捆绑包SKU。 Example: kg_1

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

包含商品本地化名称的对象。值接受以下两种格式之一：两个小写字母的语言代码（例如，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

(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 <= 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

bundle_type

string

Default: "standard"

捆绑包类型。使用standard创建包含商品的捆绑包，并指定捆绑包中所含商品的SKU。使用partner_side_content创建一个空的捆绑包，并使用Webhook在己侧添加商品。此类型仅用于合作伙伴侧的目录个性化。

Enum: "standard" "partner_side_content"

Array of objects non-empty

Array (non-empty)

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$ 唯一商品ID。 SKU只能包含大小写英文字母和数字字符、句点、破折号和下划线。
quantity	integer >= 1 Default: 1 所选商品在捆绑包中的数量。

custom_attributes

object <json> <= 500 characters

包含商品属性和值的JSON对象。属性允许您向商品添加更多信息，例如玩家使用该商品所需的等级。属性可丰富游戏的内部逻辑，并且可以通过专用的GET方法和webhook进行访问。

groups

Array of strings

Default: []

商品所属的组。

注：字符串值引用组`external_id`。

image_url

string or null

图像URL。

is_enabled

boolean

Default: true

如果禁用，则无法找到和购买该商品。

is_free

boolean

Default: false

如果为true，则该商品为免费。

is_show_in_store

boolean

Default: false

商品可供购买。

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

包含商品详细本地化描述的对象。值接受以下两种格式之一：两个小写字母的语言代码（例如，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 or null

捆绑包的附加资源。

Array

type	string 媒体类型：`image`/`video`。 Enum: "image" "video"
url	string 资源文件。

order

integer

Default: 1

列表中的捆绑包顺序优先级。

Array of objects or null

商品促销时间段。

Array

date_from	string <date-time> 指定商品促销开始的日期。
date_until	string or null <date-time> 指定商品停止促销的日期。可以为`null`。

Array of objects

以真实货币表示的价格。

Array

amount required	string^\d\.?\d$ 商品价格。
currency required	string 商品价格货币。每ISO 4217。
is_default required	boolean 如果未指定用户货币下的价格，则使用默认价格来生成目录。
is_enabled required	boolean 价格已启用。
country_iso	string or null 适用此价格的国家/地区。符合ISO 3166-1 alpha 2的两字母代码。

Array of objects

Array

id	integer >= 1

Array of objects or null

Array

amount required	integer
is_default required	boolean
is_enabled required	boolean
sku	string 唯一商品ID。 SKU只能包含大小写英文字母和数字字符、句点、破折号和下划线。

Responses

204

捆绑包已成功更新。

401

基本认证未通过或错误。确保您使用了基本认证或正确的凭据。

422

无效请求。

Request samples

application/json

{"attributes": [{"external_id": "class",
"name": {"en": "Class"
},
"values": [{"external_id": "soldier",
"value": {"en": "Soldier"
}
},
{"external_id": "officer",
"value": {"en": "Officer"
}
}
]
}
],
"content": [{"quantity": 1,
"sku": "com.xsolla.iron_gloves_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_boots_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_shield_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_armour_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_helmet_1"
}
],
"custom_attributes": {"purchased": 0,
"type": "lootbox"
},
"description": {"de": "Brustpanzer für Soldaten",
"en": "Chest of armour for soldiers"
},
"groups": ["chests"
],
"image_url": "https://picture.bundle-with-many-stuff.png",
"is_enabled": true,
"is_free": true,
"limits": {"per_item": null,
"per_user": null
},
"long_description": {"de": "Brustpanzer für Soldaten",
"en": "Chest of armour for soldiers"
},
"media_list": [{"type": "image",
"url": "https://test.com/image0"
},
{"type": "image",
"url": "https://test.com/image1"
}
],
"name": {"de": "Brustpanzer",
"en": "Chest of armour"
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": "9.99",
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": "9.99",
"currency": "EUR",
"is_default": false,
"is_enabled": true
}
],
"sku": "com.xsolla.armour_chest_1",
"vc_prices": [ ]
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}