如何通过JSON导入来创建和更新商品目录
您可以通过从JSON文件导入来创建、更新或禁用商品。
通过此工具,您可以:
功能:
- 支持以下类型的商品:
- 虚拟物品
- 虚拟货币
- 虚拟货币套餐
- 捆绑包
- 数据验证。如文件结构或数据格式不符合要求,导入时将看到以下错误列表。
限制:
注:
对于预先创建好的商品,可从CSV文件中导入区域价格。
导入商品目录
要从文件导入商品目录:
- 在发布商帐户中打开项目。
- 在侧边栏中,单击商店,然后前往虚拟货币、虚拟物品或捆绑包部分。
- 单击导入商品。
- 选择操作:
- 添加新商品 — 仅添加具有新SKU的商品。
- 添加新商品并更新现有商品 — 将添加具有新SKU的商品,且将更新现有商品的数据。
- 添加新商品,更新现有商品并禁用缺失的商品 — 将添加/更新文件中具有SKU的商品。如目录中有某个商品,但文件中没有SKU,则该商品在发布商帐户中的状态将变为部分可用 — 商品将无法单独购买,但可以作为捆绑包或奖励的一部分提供。
- 填充文件以便导入:
- 在下载窗口中下载文件模板,根据下方示例进行填写。
- 导出商品并用导出的文件作为模板。
- 创建您自己的JSON文件并按照下方示例进行填写。
完整JSON文件示例:
Copy
- json
{
"virtual_currency": [
{
"sku": "Gem_test_import",
"name": {
"en": "Gem_test_import"
},
"type": "virtual_currency",
"description": {
"en": "my test imported currency"
},
"image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
"description": {
"en": "my test imported currency",
"de": "meine importierte Testwährung"
},
"attributes": [],
"is_free": false,
"order": 1,
"groups": [],
"regional_prices": [],
"prices": [
{
"amount": 2,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"media_list": [],
"vc_prices": [],
"is_enabled": true,
"is_show_in_store": true,
"regions": [],
"limits": {
"per_user": null,
"per_item": null,
"recurrent_schedule": null
},
"periods": [],
"inventory_options": {
"consumable": true,
"expiration_period": null
},
"is_hard": false
}
],
"virtual_items": [
{
"sku": "event_access_test_import",
"name": {
"en": "Special Event Access_test_import"
},
"type": "virtual_good",
"description": {
"en": "Get special event access as a bonus only on your first purchase. Find the right doggy at the Robo-Dog Exhibition!"
},
"image_url": "https://cdn3.xsolla.com/img/misc/images/1e3ef1a96cc9dd8d98bc124d5d6fad79.png",
"long_description": null,
"attributes": [],
"is_free": false,
"order": 1,
"groups": [
"my_test_group"
],
"regional_prices": [],
"prices": [
{
"amount": 35,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"media_list": [],
"vc_prices": [],
"is_enabled": true,
"is_show_in_store": true,
"regions": [],
"limits": {
"per_user": null,
"per_item": null,
"recurrent_schedule": null
},
"periods": [],
"inventory_options": {
"consumable": true,
"expiration_period": null
}
}
],
"virtual_currency_packages": [
{
"item_id": 441982,
"sku": "small_gold_pack_test_import",
"type": "bundle",
"name": {
"en": "Small gold pack"
},
"bundle_type": "virtual_currency_package",
"description": {
"en": "Gold x100"
},
"image_url": "https://cdn3.xsolla.com/img/misc/images/ba43c46ea75fd5713c210f5736993a92.png",
"vc_prices": [],
"regional_prices": [],
"prices": [
{
"amount": 5,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"is_enabled": true,
"is_show_in_store": true,
"regions": [],
"limits": {
"per_user": null,
"per_item": null,
"recurrent_schedule": null
},
"periods": [],
"attributes": [],
"long_description": null,
"media_list": [],
"order": 100000000,
"is_free": false,
"groups": [],
"content": [
{
"sku": "Gem_test_import",
"quantity": 100
}
]
}
],
"bundles": [
{
"item_id": 684024,
"sku": "start_pack_test_import_test_import",
"type": "bundle",
"name": {
"en": "Legendary Start Pack"
},
"bundle_type": "standard",
"description": {
"en": "Crystal x 1\nGem x 1"
},
"image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
"regional_prices": [],
"prices": [
{
"amount": 20,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"virtual_prices": [],
"is_enabled": true,
"is_show_in_store": true,
"regions": [],
"limits": {
"per_user": null,
"per_item": null,
"recurrent_schedule": null
},
"periods": [],
"attributes": [],
"long_description": null,
"media_list": [],
"order": 5,
"is_free": false,
"groups": [
"my_test_group"
],
"content": [
{
"sku": "Gem_test_import",
"quantity": 1
},
{
"sku": "event_access_test_import",
"quantity": 1
}
]
}
]
}
- 在导入窗口的相应字段中上传完整文件。
- 如导入过程中发生错误,导入窗口中将显示错误列表和改正建议。请对文件作出必要更改,然后重新上传。
成功上传后,具有指定SKU的商品将完成创建、更新或禁用。
导出商品目录
要将一个商品或商品目录导出到JSON文件:
- 在发布商帐户中打开项目。
- 在侧边栏中,单击商店,然后前往虚拟货币、虚拟物品或捆绑包部分。
- 单击导出商品。
- 选择操作:
- 导出全部商品 — 将导出包含该项目所有类型商品的完整目录。例如您前往虚拟货币部分并导出所有商品,JSON文件将导出项目的虚拟货币、虚拟货币套餐、虚拟物品和游戏密钥套餐。
- 仅导出所选商品 — 在打开的窗口中选择要导出的商品。
- 单击导出。
JSON文件将自动开始下载。
本文对您的有帮助吗?
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。