如何通过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文件导入商品API调用来导入商品。
为避免导入过程中发生错误，请按照上文中的建议填充文件。
为避免导入过程中发生错误，请按照上文中的建议填充文件。
导出商品目录
要将一个商品或商品目录导出到JSON文件：
- 在发布商帐户中打开项目。
- 在侧边栏中，单击商店，然后前往虚拟货币、虚拟物品或捆绑包部分。
- 单击导出商品。
- 选择操作：
- 导出全部商品 — 将导出包含该项目所有类型商品的完整目录。例如您前往虚拟货币部分并导出所有商品，JSON文件将导出项目的虚拟货币、虚拟货币套餐、虚拟物品和游戏密钥套餐。
- 仅导出所选商品 — 在打开的窗口中选择要导出的商品。
- 单击导出。
JSON文件将自动开始下载。
本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
