Как создать и обновить каталог товаров с помощью импорта из JSON
Вы можете создать, обновить или отключить товары с помощью импорта из JSON-файла.
Примечание
Вы можете создать, обновить или отключить товары, используя методы API или вручную в Личном кабинете. При этом для каждого товара потребуется выполнять отдельный запрос или действие. С помощью импорта вы можете выполнить указанные действия для множества товаров одновременно, указав их в одном JSON-файле.
С помощью этого инструмента вы можете:
Возможности:
- Поддержка следующих типов товаров:
- виртуальных предметов;
- виртуальной валюты;
- пакетов виртуальной валюты;
- бандлов.
- Валидация загружаемых данных. Если структура файла или формат данных не соответствуют требованиям, вы увидите список ошибок при импорте.
Ограничения:
- Импорт недоступен для игровых ключей, акций и системы вознаграждений.
- Размер загружаемого JSON-файла не должен превышать 7 МБ.
- Формат параметров в JSON-файле должен соответствовать формату, указанному в соответствующем методе создания товара:
Примечание
Для предварительно созданных товаров вы можете импортировать региональные цены из CSV-файла.
Импорт каталога товаров
Чтобы импортировать каталог товаров из файла:
- Откройте проект в Личном кабинете.
- В боковом меню нажмите Store и перейдите в раздел Виртуальная валюта, Виртуальные предметы или Бандлы.
- Нажмите Импортировать товары.
- Выберите нужное действие:
- Добавить новые товары — будут добавлены только товары с новыми артикулами.
- Добавить новые товары и обновить существующие — будут добавлены товары с новыми артикулами и обновлены данные существующих товаров.
- Добавить новые, обновить существующие и отключить недостающие товары — товары с артикулами из файла будут добавлены/обновлены. Если товар есть в каталоге, но товара с таким артикулом нет в файле, статус товара в Личном кабинете будет изменен на Частично доступен. Такой товар нельзя приобрести отдельно, но он доступен в составе бандла или в качестве бонуса.
- Заполните файл для импорта:
- Скачайте шаблон файла в окне загрузки и заполните его по примеру ниже.
- Сделайте экспорт товаров и используйте экспортированный файл как шаблон.
- Создайте свой 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
}
]
}
]
}
- Загрузите заполненный файл в соответствующее поле в окне импорта.
- Если при импорте возникнут ошибки, в окне импорта отобразится список этих ошибок и рекомендаций по исправлению. Внесите необходимые изменения в файл и загрузите его снова.
После успешной загрузки товары с указанными артикулами будут созданы, обновлены или отключены.
Экспорт каталога товаров
Чтобы экспортировать товар или каталог товаров в JSON-файл:
- Откройте проект в Личном кабинете.
- В боковом меню нажмите Store и перейдите в раздел Виртуальная валюта, Виртуальные предметы или Бандлы.
- Нажмите Экспортировать товары.
- Выберите нужное действие:
- Экспортировать все товары — будет выгружен весь каталог всех типов товаров данного проекта. Например, если вы перешли в раздел Виртуальная валюта и экспортируете все товары, в JSON-файл будут выгружены виртуальные валюты, пакеты виртуальной валюты, виртуальные предметы, пакеты игровых ключей вашего проекта.
- Экспортировать только выбранные товары — в открывшемся окне выберите товары, которые должны быть экспортированы.
- Нажмите Экспортировать.
Загрузка JSON-файла начнется автоматически.
Была ли статья полезна?
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.