JSON 가져오기를 사용하여 항목 카탈로그를 생성하고 업데이트하는 방법

JSON 파일에서 가져오기를 사용하여 항목을 생성, 업데이트 또는 비활성화할 수 있습니다.

알림
API 호출 또는 관리자 페이지에서 수동으로 항목을 생성, 업데이트 또는 비활성화할 수 있습니다. 단, 각 항목에 대해 별도의 요청 또는 작업을 수행해야 합니다. 가져오기를 사용하면 단일 JSON 파일에 지정하여 여러 항목에 대해 이러한 작업을 동시에 수행할 수 있습니다.

이 도구로 할 수 있는 작업:

특징:

  • 다음 유형의 항목 지원:
    • 가상 아이템
    • 인게임 재화
    • 인게임 재화 패키지
    • 번들
  • 데이터 유효성 검사. 파일 구조나 데이터 형식이 요구 사항을 충족하지 않으면 가져올 때 오류 목록이 표시됩니다.

제한 사항:

알림
미리 생성된 항목의 경우 CSV 파일에서 지역 가격을 가져오기를 수행할 수 있습니다.

항목 카탈로그 가져오기

파일에서 아이템 카탈로그를 가져오는 방법:

  1. 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 인게임 재화, 아이템 카탈로그 > 가상 아이템, 또는 아이템 카탈로그 > 번들 섹션으로 이동합니다.
  2. 아이템 가져오기를 클릭합니다 .

  1. 작업 선택 :
    • 새 항목 추가 - 새 SKU가 있는 항목만 추가됩니다.
    • 새 항목 추가 및 기존 항목 업데이트 - 새 SKU가 있는 항목이 추가되고 기존 항목의 데이터가 업데이트됩니다.
    • 새 항목 추가, 기존 항목 업데이트, 누락 항목 비활성화 - 파일에서 SKU가 있는 항목이 추가/업데이트됩니다. 카탈로그에는 항목이 있지만 파일에 해당 SKU가 없는 경우 관리자 페이지에서 항목 상태가 부분적으로 사용 가능으로 표시되며, 이 경우 항목을 별도로 구매할 수 없지만 번들 또는 보너스의 일부로 사용할 수 있습니다.

  1. 가져올 파일 작성하기:
    • 다운로드 창에서 파일 템플릿을 다운로드하고 아래 예시에 따라 파일을 작성합니다.
    • 항목을 내보내고 내보낸 파일을 템플릿으로 사용합니다.
    • 자체 JSON 파일을 생성하여 아래 예시에 따라 작성합니다.

전체 JSON 파일의 예시:

Copy
Full screen
Small screen
   1{
   2    "virtual_currency": [
   3        {
   4            "item_id": 952122,
   5            "sku": "11cog1005",
   6            "name": {
   7                "en": "Gearlings"
   8            },
   9            "type": "virtual_currency",
  10            "description": null,
  11            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/c9fac97d44242e73c4b74e9b5c7b3ae0.webp",
  12            "long_description": null,
  13            "attributes": [],
  14            "is_free": true,
  15            "order": 1,
  16            "groups": [],
  17            "regional_prices": [],
  18            "prices": [],
  19            "media_list": [],
  20            "vc_prices": [],
  21            "is_enabled": true,
  22            "is_show_in_store": true,
  23            "regions": [],
  24            "limits": {
  25                "per_user": null,
  26                "per_item": null,
  27                "recurrent_schedule": null
  28            },
  29            "periods": [],
  30            "inventory_options": {
  31                "consumable": true,
  32                "expiration_period": null
  33            },
  34            "is_hard": false
  35        },
  36        {
  37            "item_id": 952108,
  38            "sku": "11cog1003",
  39            "name": {
  40                "en": "Brass Bits"
  41            },
  42            "type": "virtual_currency",
  43            "description": null,
  44            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/26232b5a9e550818f094f769b388a4a2.webp",
  45            "long_description": null,
  46            "attributes": [],
  47            "is_free": true,
  48            "order": 1,
  49            "groups": [],
  50            "regional_prices": [],
  51            "prices": [],
  52            "media_list": [],
  53            "vc_prices": [],
  54            "is_enabled": true,
  55            "is_show_in_store": true,
  56            "regions": [],
  57            "limits": {
  58                "per_user": null,
  59                "per_item": null,
  60                "recurrent_schedule": null
  61            },
  62            "periods": [],
  63            "inventory_options": {
  64                "consumable": true,
  65                "expiration_period": null
  66            },
  67            "is_hard": false
  68        },
  69        {
  70            "item_id": 952103,
  71            "sku": "11cog1002",
  72            "name": {
  73                "en": "Steam Tokens"
  74            },
  75            "type": "virtual_currency",
  76            "description": null,
  77            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/2985a68253dd10c0d1edbed1d11d1c00.webp",
  78            "long_description": null,
  79            "attributes": [],
  80            "is_free": true,
  81            "order": 1,
  82            "groups": [],
  83            "regional_prices": [],
  84            "prices": [],
  85            "media_list": [],
  86            "vc_prices": [],
  87            "is_enabled": true,
  88            "is_show_in_store": true,
  89            "regions": [],
  90            "limits": {
  91                "per_user": null,
  92                "per_item": null,
  93                "recurrent_schedule": null
  94            },
  95            "periods": [],
  96            "inventory_options": {
  97                "consumable": true,
  98                "expiration_period": null
  99            },
 100            "is_hard": false
 101        },
 102        {
 103            "item_id": 952092,
 104            "sku": "11cog1001",
 105            "name": {
 106                "en": "Cogcoins"
 107            },
 108            "type": "virtual_currency",
 109            "description": null,
 110            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/5af6212dba648b7a9192311a786baf5a.webp",
 111            "long_description": null,
 112            "attributes": [],
 113            "is_free": true,
 114            "order": 1,
 115            "groups": [],
 116            "regional_prices": [],
 117            "prices": [],
 118            "media_list": [],
 119            "vc_prices": [],
 120            "is_enabled": true,
 121            "is_show_in_store": true,
 122            "regions": [],
 123            "limits": {
 124                "per_user": null,
 125                "per_item": null,
 126                "recurrent_schedule": null
 127            },
 128            "periods": [],
 129            "inventory_options": {
 130                "consumable": true,
 131                "expiration_period": null
 132            },
 133            "is_hard": false
 134        },
 135        {
 136            "item_id": 952118,
 137            "sku": "11cog1004",
 138            "name": {
 139                "en": "Clockwork Crowns"
 140            },
 141            "type": "virtual_currency",
 142            "description": null,
 143            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/ca9b753f23a129f8caa52f85a3d9b287.png",
 144            "long_description": null,
 145            "attributes": [],
 146            "is_free": true,
 147            "order": 1,
 148            "groups": [],
 149            "regional_prices": [],
 150            "prices": [],
 151            "media_list": [],
 152            "vc_prices": [],
 153            "is_enabled": true,
 154            "is_show_in_store": true,
 155            "regions": [],
 156            "limits": {
 157                "per_user": null,
 158                "per_item": null,
 159                "recurrent_schedule": null
 160            },
 161            "periods": [],
 162            "inventory_options": {
 163                "consumable": true,
 164                "expiration_period": null
 165            },
 166            "is_hard": false
 167        }
 168    ],
 169    "virtual_items": [
 170        {
 171            "item_id": 952158,
 172            "sku": "23svvs1007",
 173            "name": {
 174                "en": "Hypnotic Lantern \"Hypnomouse\""
 175            },
 176            "type": "virtual_good",
 177            "description": {
 178                "en": "A lantern with mesmerizing lenses that temporarily stuns enemies."
 179            },
 180            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/eedc2397bcf5d52745bd07e9c18eb02c.webp",
 181            "long_description": null,
 182            "attributes": [],
 183            "is_free": false,
 184            "order": 1,
 185            "groups": [
 186                "214njksv001"
 187            ],
 188            "regional_prices": [],
 189            "prices": [],
 190            "media_list": [],
 191            "vc_prices": [
 192                {
 193                    "sku": "11cog1001",
 194                    "is_default": true,
 195                    "amount": 20
 196                }
 197            ],
 198            "is_enabled": true,
 199            "is_show_in_store": true,
 200            "regions": [],
 201            "limits": {
 202                "per_user": null,
 203                "per_item": null,
 204                "recurrent_schedule": null
 205            },
 206            "periods": [],
 207            "inventory_options": {
 208                "consumable": true,
 209                "expiration_period": null
 210            }
 211        },
 212        {
 213            "item_id": 952160,
 214            "sku": "23svvs1005",
 215            "name": {
 216                "en": "Noise Generator \"Echo\""
 217            },
 218            "type": "virtual_good",
 219            "description": {
 220                "en": "A small device that emits a loud sound, distracting enemies."
 221            },
 222            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/98a6f1856e530ef86a3ecf32abc4fac7.webp",
 223            "long_description": null,
 224            "attributes": [],
 225            "is_free": false,
 226            "order": 1,
 227            "groups": [
 228                "214njksv001"
 229            ],
 230            "regional_prices": [],
 231            "prices": [],
 232            "media_list": [],
 233            "vc_prices": [
 234                {
 235                    "sku": "11cog1001",
 236                    "is_default": true,
 237                    "amount": 15
 238                }
 239            ],
 240            "is_enabled": true,
 241            "is_show_in_store": true,
 242            "regions": [],
 243            "limits": {
 244                "per_user": null,
 245                "per_item": null,
 246                "recurrent_schedule": null
 247            },
 248            "periods": [],
 249            "inventory_options": {
 250                "consumable": true,
 251                "expiration_period": null
 252            }
 253        },
 254        {
 255            "item_id": 952161,
 256            "sku": "23svvs1004",
 257            "name": {
 258                "en": "\"Infra-Gear\" Goggles"
 259            },
 260            "type": "virtual_good",
 261            "description": {
 262                "en": "Special steampunk glasses revealing invisible lasers and hidden mechanisms."
 263            },
 264            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/d2039a7e0cb290b0dfe3e3baedbdaa88.webp",
 265            "long_description": null,
 266            "attributes": [],
 267            "is_free": false,
 268            "order": 1,
 269            "groups": [
 270                "214njksv001"
 271            ],
 272            "regional_prices": [],
 273            "prices": [],
 274            "media_list": [],
 275            "vc_prices": [
 276                {
 277                    "sku": "11cog1001",
 278                    "is_default": true,
 279                    "amount": 10
 280                }
 281            ],
 282            "is_enabled": true,
 283            "is_show_in_store": true,
 284            "regions": [],
 285            "limits": {
 286                "per_user": null,
 287                "per_item": null,
 288                "recurrent_schedule": null
 289            },
 290            "periods": [],
 291            "inventory_options": {
 292                "consumable": true,
 293                "expiration_period": null
 294            }
 295        },
 296        {
 297            "item_id": 952163,
 298            "sku": "23svvs1002",
 299            "name": {
 300                "en": "Steam Hook \"Harpooner\""
 301            },
 302            "type": "virtual_good",
 303            "description": {
 304                "en": "A miniature steam-powered grappling hook that pulls the user toward distant platforms."
 305            },
 306            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/2192f4936fbf048f4d3ae88e68f7d0b8.webp",
 307            "long_description": null,
 308            "attributes": [],
 309            "is_free": false,
 310            "order": 1,
 311            "groups": [
 312                "214njksv001"
 313            ],
 314            "regional_prices": [],
 315            "prices": [],
 316            "media_list": [],
 317            "vc_prices": [
 318                {
 319                    "sku": "11cog1001",
 320                    "is_default": true,
 321                    "amount": 5
 322                }
 323            ],
 324            "is_enabled": true,
 325            "is_show_in_store": true,
 326            "regions": [],
 327            "limits": {
 328                "per_user": null,
 329                "per_item": null,
 330                "recurrent_schedule": null
 331            },
 332            "periods": [],
 333            "inventory_options": {
 334                "consumable": true,
 335                "expiration_period": null
 336            }
 337        },
 338        {
 339            "item_id": 952157,
 340            "sku": "23svvs1008",
 341            "name": {
 342                "en": "\"Shadow Leaf\" Cloak"
 343            },
 344            "type": "virtual_good",
 345            "description": {
 346                "en": "A lightweight metallic fabric that makes the mouse harder to spot in darkness."
 347            },
 348            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/31936e094096d3250d69ccbdbbee139b.webp",
 349            "long_description": null,
 350            "attributes": [],
 351            "is_free": false,
 352            "order": 1,
 353            "groups": [
 354                "214njksv002"
 355            ],
 356            "regional_prices": [],
 357            "prices": [],
 358            "media_list": [],
 359            "vc_prices": [
 360                {
 361                    "sku": "11cog1002",
 362                    "is_default": true,
 363                    "amount": 25
 364                }
 365            ],
 366            "is_enabled": true,
 367            "is_show_in_store": true,
 368            "regions": [],
 369            "limits": {
 370                "per_user": null,
 371                "per_item": null,
 372                "recurrent_schedule": null
 373            },
 374            "periods": [],
 375            "inventory_options": {
 376                "consumable": true,
 377                "expiration_period": null
 378            }
 379        },
 380        {
 381            "item_id": 952156,
 382            "sku": "23svvs1009",
 383            "name": {
 384                "en": "Gear Shield \"Brassguard\""
 385            },
 386            "type": "virtual_good",
 387            "description": {
 388                "en": "A rotating shield made of interlocked gears, deflecting attacks."
 389            },
 390            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/527058d1b9cdb73613c9e8db978e216a.webp",
 391            "long_description": null,
 392            "attributes": [],
 393            "is_free": false,
 394            "order": 1,
 395            "groups": [
 396                "214njksv002"
 397            ],
 398            "regional_prices": [],
 399            "prices": [],
 400            "media_list": [],
 401            "vc_prices": [
 402                {
 403                    "sku": "11cog1002",
 404                    "is_default": true,
 405                    "amount": 25
 406                }
 407            ],
 408            "is_enabled": true,
 409            "is_show_in_store": true,
 410            "regions": [],
 411            "limits": {
 412                "per_user": null,
 413                "per_item": null,
 414                "recurrent_schedule": null
 415            },
 416            "periods": [],
 417            "inventory_options": {
 418                "consumable": true,
 419                "expiration_period": null
 420            }
 421        },
 422        {
 423            "item_id": 952152,
 424            "sku": "23svvs1013",
 425            "name": {
 426                "en": "Steam Teleporter \"Jumper\""
 427            },
 428            "type": "virtual_good",
 429            "description": {
 430                "en": "A small device that allows short-range teleportation, bypassing obstacles."
 431            },
 432            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/a329e818f53be7ff0ff45a71c9e8925e.webp",
 433            "long_description": null,
 434            "attributes": [],
 435            "is_free": false,
 436            "order": 1,
 437            "groups": [
 438                "214njksv003"
 439            ],
 440            "regional_prices": [],
 441            "prices": [],
 442            "media_list": [],
 443            "vc_prices": [
 444                {
 445                    "sku": "11cog1003",
 446                    "is_default": true,
 447                    "amount": 40
 448                }
 449            ],
 450            "is_enabled": true,
 451            "is_show_in_store": true,
 452            "regions": [],
 453            "limits": {
 454                "per_user": null,
 455                "per_item": null,
 456                "recurrent_schedule": null
 457            },
 458            "periods": [],
 459            "inventory_options": {
 460                "consumable": true,
 461                "expiration_period": null
 462            }
 463        },
 464        {
 465            "item_id": 952150,
 466            "sku": "23svvs1015",
 467            "name": {
 468                "en": "Remote-Controlled Beetle \"Bug-Bot\""
 469            },
 470            "type": "virtual_good",
 471            "description": {
 472                "en": "A tiny mechanical insect capable of crawling into tight spaces and activating switches."
 473            },
 474            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/c469d00554d49968886eee8ebf7211fa.webp",
 475            "long_description": null,
 476            "attributes": [],
 477            "is_free": false,
 478            "order": 1,
 479            "groups": [
 480                "214njksv003"
 481            ],
 482            "regional_prices": [],
 483            "prices": [],
 484            "media_list": [],
 485            "vc_prices": [
 486                {
 487                    "sku": "11cog1003",
 488                    "is_default": true,
 489                    "amount": 45
 490                }
 491            ],
 492            "is_enabled": true,
 493            "is_show_in_store": true,
 494            "regions": [],
 495            "limits": {
 496                "per_user": null,
 497                "per_item": null,
 498                "recurrent_schedule": null
 499            },
 500            "periods": [],
 501            "inventory_options": {
 502                "consumable": true,
 503                "expiration_period": null
 504            }
 505        },
 506        {
 507            "item_id": 952149,
 508            "sku": "23svvs1016",
 509            "name": {
 510                "en": "Key of the Mechmaster"
 511            },
 512            "type": "virtual_good",
 513            "description": {
 514                "en": "A legendary artifact that grants control over the most intricate mechanisms."
 515            },
 516            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/640e580b7be16210cf9262987bc51a1d.webp",
 517            "long_description": null,
 518            "attributes": [],
 519            "is_free": false,
 520            "order": 1,
 521            "groups": [
 522                "214njksv004"
 523            ],
 524            "regional_prices": [],
 525            "prices": [],
 526            "media_list": [],
 527            "vc_prices": [
 528                {
 529                    "sku": "11cog1004",
 530                    "is_default": true,
 531                    "amount": 45
 532                }
 533            ],
 534            "is_enabled": true,
 535            "is_show_in_store": true,
 536            "regions": [],
 537            "limits": {
 538                "per_user": null,
 539                "per_item": null,
 540                "recurrent_schedule": null
 541            },
 542            "periods": [],
 543            "inventory_options": {
 544                "consumable": true,
 545                "expiration_period": null
 546            }
 547        },
 548        {
 549            "item_id": 952148,
 550            "sku": "23svvs1017",
 551            "name": {
 552                "en": "Heart of the Clockwork King"
 553            },
 554            "type": "virtual_good",
 555            "description": {
 556                "en": "A rare component capable of reactivating broken automatons."
 557            },
 558            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/d279721a03809d530ad26bd87feae9d7.webp",
 559            "long_description": null,
 560            "attributes": [],
 561            "is_free": false,
 562            "order": 1,
 563            "groups": [
 564                "214njksv004"
 565            ],
 566            "regional_prices": [],
 567            "prices": [],
 568            "media_list": [],
 569            "vc_prices": [
 570                {
 571                    "sku": "11cog1004",
 572                    "is_default": true,
 573                    "amount": 50
 574                }
 575            ],
 576            "is_enabled": true,
 577            "is_show_in_store": true,
 578            "regions": [],
 579            "limits": {
 580                "per_user": null,
 581                "per_item": null,
 582                "recurrent_schedule": null
 583            },
 584            "periods": [],
 585            "inventory_options": {
 586                "consumable": true,
 587                "expiration_period": null
 588            }
 589        },
 590        {
 591            "item_id": 952147,
 592            "sku": "23svvs1018",
 593            "name": {
 594                "en": "Anti-Gravity Generator"
 595            },
 596            "type": "virtual_good",
 597            "description": {
 598                "en": "A mysterious steampunk device that temporarily allows levitation."
 599            },
 600            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/b81801ad7b7e870d8834e24eb388721c.webp",
 601            "long_description": null,
 602            "attributes": [],
 603            "is_free": false,
 604            "order": 1,
 605            "groups": [
 606                "214njksv004"
 607            ],
 608            "regional_prices": [],
 609            "prices": [],
 610            "media_list": [],
 611            "vc_prices": [
 612                {
 613                    "sku": "11cog1004",
 614                    "is_default": true,
 615                    "amount": 55
 616                }
 617            ],
 618            "is_enabled": true,
 619            "is_show_in_store": true,
 620            "regions": [],
 621            "limits": {
 622                "per_user": null,
 623                "per_item": null,
 624                "recurrent_schedule": null
 625            },
 626            "periods": [],
 627            "inventory_options": {
 628                "consumable": true,
 629                "expiration_period": null
 630            }
 631        },
 632        {
 633            "item_id": 952146,
 634            "sku": "23svvs1019",
 635            "name": {
 636                "en": "Alchemical Reactor \"Philosopher\u2019s Steam\""
 637            },
 638            "type": "virtual_good",
 639            "description": {
 640                "en": "An artifact capable of temporarily transmuting mechanisms into gold."
 641            },
 642            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/529c0d2107d2861f64bb94a94787020a.webp",
 643            "long_description": null,
 644            "attributes": [],
 645            "is_free": false,
 646            "order": 1,
 647            "groups": [
 648                "214njksv004"
 649            ],
 650            "regional_prices": [],
 651            "prices": [],
 652            "media_list": [],
 653            "vc_prices": [
 654                {
 655                    "sku": "11cog1004",
 656                    "is_default": true,
 657                    "amount": 60
 658                }
 659            ],
 660            "is_enabled": true,
 661            "is_show_in_store": true,
 662            "regions": [],
 663            "limits": {
 664                "per_user": null,
 665                "per_item": null,
 666                "recurrent_schedule": null
 667            },
 668            "periods": [],
 669            "inventory_options": {
 670                "consumable": true,
 671                "expiration_period": null
 672            }
 673        },
 674        {
 675            "item_id": 975277,
 676            "sku": "demopaid_2",
 677            "name": {
 678                "en": "Power-Up Puzzle Booster"
 679            },
 680            "type": "virtual_good",
 681            "description": {
 682                "en": "Boost your puzzle-solving skills with the Power-Up Puzzle Booster! Gain extra moves and power-ups to conquer challenging levels."
 683            },
 684            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/529456d9bfddb50b29fa85d1d6ec787d.png",
 685            "long_description": null,
 686            "attributes": [],
 687            "is_free": false,
 688            "order": 0,
 689            "groups": [
 690                "demo-vi-1"
 691            ],
 692            "regional_prices": [],
 693            "prices": [
 694                {
 695                    "amount": 4.99,
 696                    "currency": "USD",
 697                    "is_default": true,
 698                    "is_enabled": true
 699                }
 700            ],
 701            "media_list": [],
 702            "vc_prices": [],
 703            "is_enabled": true,
 704            "is_show_in_store": true,
 705            "regions": [],
 706            "limits": {
 707                "per_user": null,
 708                "per_item": null,
 709                "recurrent_schedule": null
 710            },
 711            "periods": [],
 712            "inventory_options": {
 713                "consumable": true,
 714                "expiration_period": null
 715            }
 716        },
 717        {
 718            "item_id": 975278,
 719            "sku": "demopaid_3",
 720            "name": {
 721                "en": "Golden Key to Secrets"
 722            },
 723            "type": "virtual_good",
 724            "description": {
 725                "en": "Unlock hidden treasures in your home with the Golden Key! Discover exclusive design options and rare collectibles."
 726            },
 727            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/762acdbcd55056d444221061e172fadc.png",
 728            "long_description": null,
 729            "attributes": [],
 730            "is_free": false,
 731            "order": 0,
 732            "groups": [
 733                "demo-vi-1"
 734            ],
 735            "regional_prices": [],
 736            "prices": [
 737                {
 738                    "amount": 9.99,
 739                    "currency": "USD",
 740                    "is_default": true,
 741                    "is_enabled": true
 742                }
 743            ],
 744            "media_list": [],
 745            "vc_prices": [],
 746            "is_enabled": true,
 747            "is_show_in_store": true,
 748            "regions": [],
 749            "limits": {
 750                "per_user": null,
 751                "per_item": null,
 752                "recurrent_schedule": null
 753            },
 754            "periods": [],
 755            "inventory_options": {
 756                "consumable": true,
 757                "expiration_period": null
 758            }
 759        },
 760        {
 761            "item_id": 975281,
 762            "sku": "demofree_2",
 763            "name": {
 764                "en": "Weekly Puzzle Challenge"
 765            },
 766            "type": "virtual_good",
 767            "description": {
 768                "en": "Join the Weekly Puzzle Challenge! Complete the puzzle to earn special rewards and boost your gameplay."
 769            },
 770            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/cc3c05847f3c2afa8a190e8ce79fca05.png",
 771            "long_description": null,
 772            "attributes": [],
 773            "is_free": true,
 774            "order": 0,
 775            "groups": [
 776                "demo-free-vi-1"
 777            ],
 778            "regional_prices": [],
 779            "prices": [],
 780            "media_list": [],
 781            "vc_prices": [],
 782            "is_enabled": true,
 783            "is_show_in_store": true,
 784            "regions": [],
 785            "limits": {
 786                "per_user": 1,
 787                "per_item": null,
 788                "recurrent_schedule": {
 789                    "per_user": {
 790                        "interval_type": "weekly",
 791                        "day_of_week": 1,
 792                        "day_of_month": null,
 793                        "time": "00:00:00+00:00"
 794                    }
 795                }
 796            },
 797            "periods": [],
 798            "inventory_options": {
 799                "consumable": true,
 800                "expiration_period": null
 801            }
 802        },
 803        {
 804            "item_id": 975280,
 805            "sku": "demofree_1",
 806            "name": {
 807                "en": "Daily Design Boost"
 808            },
 809            "type": "virtual_good",
 810            "description": {
 811                "en": "Claim your Daily Design Boost! Receive a surprise item to help you in your home renovation journey."
 812            },
 813            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/8598fec375d90826d8afdc2cb27cefbc.png",
 814            "long_description": null,
 815            "attributes": [],
 816            "is_free": true,
 817            "order": 0,
 818            "groups": [
 819                "demo-free-vi-1"
 820            ],
 821            "regional_prices": [],
 822            "prices": [],
 823            "media_list": [],
 824            "vc_prices": [],
 825            "is_enabled": true,
 826            "is_show_in_store": true,
 827            "regions": [],
 828            "limits": {
 829                "per_user": 1,
 830                "per_item": null,
 831                "recurrent_schedule": {
 832                    "per_user": {
 833                        "interval_type": "daily",
 834                        "day_of_week": null,
 835                        "day_of_month": null,
 836                        "time": "00:00:00+00:00"
 837                    }
 838                }
 839            },
 840            "periods": [],
 841            "inventory_options": {
 842                "consumable": true,
 843                "expiration_period": null
 844            }
 845        }
 846    ],
 847    "virtual_currency_packages": [
 848        {
 849            "item_id": 952185,
 850            "sku": "11cog1011",
 851            "type": "bundle",
 852            "name": {
 853                "en": "Small Cogcoin Pack"
 854            },
 855            "bundle_type": "virtual_currency_package",
 856            "description": {
 857                "en": "A handful of Cogcoins, enough to grab some basic tools or a minor upgrade. A perfect start for any daring mouse."
 858            },
 859            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/832a9ee7fc64cc017ebc9c116abe9404.webp",
 860            "vc_prices": [],
 861            "regional_prices": [],
 862            "prices": [
 863                {
 864                    "amount": 5,
 865                    "currency": "USD",
 866                    "is_default": true,
 867                    "is_enabled": true
 868                }
 869            ],
 870            "is_enabled": true,
 871            "is_show_in_store": true,
 872            "regions": [],
 873            "limits": {
 874                "per_user": null,
 875                "per_item": null,
 876                "recurrent_schedule": null
 877            },
 878            "periods": [],
 879            "attributes": [],
 880            "long_description": null,
 881            "media_list": [],
 882            "order": 1,
 883            "is_free": false,
 884            "groups": [],
 885            "content": [
 886                {
 887                    "sku": "11cog1001",
 888                    "quantity": 10
 889                }
 890            ]
 891        },
 892        {
 893            "item_id": 952186,
 894            "sku": "11cog1012",
 895            "type": "bundle",
 896            "name": {
 897                "en": "Medium Cogcoin Pack"
 898            },
 899            "bundle_type": "virtual_currency_package",
 900            "description": {
 901                "en": "A solid stash of Cogcoins, ideal for purchasing advanced gadgets and small contraptions."
 902            },
 903            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/2deef82e20f3f234817544fc5f603b84.webp",
 904            "vc_prices": [],
 905            "regional_prices": [],
 906            "prices": [
 907                {
 908                    "amount": 13,
 909                    "currency": "USD",
 910                    "is_default": true,
 911                    "is_enabled": true
 912                }
 913            ],
 914            "is_enabled": true,
 915            "is_show_in_store": true,
 916            "regions": [],
 917            "limits": {
 918                "per_user": null,
 919                "per_item": null,
 920                "recurrent_schedule": null
 921            },
 922            "periods": [],
 923            "attributes": [],
 924            "long_description": null,
 925            "media_list": [],
 926            "order": 1,
 927            "is_free": false,
 928            "groups": [],
 929            "content": [
 930                {
 931                    "sku": "11cog1001",
 932                    "quantity": 50
 933                }
 934            ]
 935        },
 936        {
 937            "item_id": 952187,
 938            "sku": "11cog1013",
 939            "type": "bundle",
 940            "name": {
 941                "en": "Large Cogcoin Pack"
 942            },
 943            "bundle_type": "virtual_currency_package",
 944            "description": {
 945                "en": "A well-stocked reserve of Cogcoins, enough to afford top-tier equipment and rare steampunk devices."
 946            },
 947            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9ce48d3243db8222f70ecbd3899abc72.webp",
 948            "vc_prices": [],
 949            "regional_prices": [],
 950            "prices": [
 951                {
 952                    "amount": 27,
 953                    "currency": "USD",
 954                    "is_default": true,
 955                    "is_enabled": true
 956                }
 957            ],
 958            "is_enabled": true,
 959            "is_show_in_store": true,
 960            "regions": [],
 961            "limits": {
 962                "per_user": null,
 963                "per_item": null,
 964                "recurrent_schedule": null
 965            },
 966            "periods": [],
 967            "attributes": [],
 968            "long_description": null,
 969            "media_list": [],
 970            "order": 1,
 971            "is_free": false,
 972            "groups": [],
 973            "content": [
 974                {
 975                    "sku": "11cog1001",
 976                    "quantity": 100
 977                }
 978            ]
 979        }
 980    ],
 981    "bundles": [
 982        {
 983            "item_id": 953085,
 984            "sku": "bndl1404v01",
 985            "type": "bundle",
 986            "name": {
 987                "en": "Tinkerer's Starter Kit"
 988            },
 989            "bundle_type": "standard",
 990            "description": {
 991                "en": "A perfect bundle for new players looking to get started with essential tools and currency. Whether you're disarming traps or crafting clever contraptions, this bundle will set you on the right track."
 992            },
 993            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/af1b43f928b0854951b0bb0971b619ac.webp",
 994            "regional_prices": [],
 995            "prices": [
 996                {
 997                    "amount": 25,
 998                    "currency": "USD",
 999                    "is_default": true,
1000                    "is_enabled": true
1001                }
1002            ],
1003            "virtual_prices": [],
1004            "is_enabled": true,
1005            "is_show_in_store": true,
1006            "regions": [],
1007            "limits": {
1008                "per_user": null,
1009                "per_item": null,
1010                "recurrent_schedule": null
1011            },
1012            "periods": [],
1013            "attributes": [],
1014            "long_description": null,
1015            "media_list": [],
1016            "order": 1,
1017            "is_free": false,
1018            "groups": [],
1019            "content": [
1020                {
1021                    "sku": "23svvs1012",
1022                    "quantity": 1
1023                },
1024                {
1025                    "sku": "23svvs1001",
1026                    "quantity": 1
1027                },
1028                {
1029                    "sku": "11cog1051",
1030                    "quantity": 1
1031                },
1032                {
1033                    "sku": "11cog1031",
1034                    "quantity": 1
1035                }
1036            ]
1037        },
1038        {
1039            "item_id": 953086,
1040            "sku": "bndl1404v02",
1041            "type": "bundle",
1042            "name": {
1043                "en": "Steam-Powered Explorer Pack"
1044            },
1045            "bundle_type": "standard",
1046            "description": {
1047                "en": "Perfect for adventurers seeking speed, stealth, and some extra Steam Tokens to power their way through obstacles."
1048            },
1049            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/68cdd1197607a225e6891aaffebcc2a1.webp",
1050            "regional_prices": [],
1051            "prices": [
1052                {
1053                    "amount": 27,
1054                    "currency": "USD",
1055                    "is_default": true,
1056                    "is_enabled": true
1057                }
1058            ],
1059            "virtual_prices": [],
1060            "is_enabled": true,
1061            "is_show_in_store": true,
1062            "regions": [],
1063            "limits": {
1064                "per_user": null,
1065                "per_item": null,
1066                "recurrent_schedule": null
1067            },
1068            "periods": [],
1069            "attributes": [],
1070            "long_description": null,
1071            "media_list": [],
1072            "order": 2,
1073            "is_free": false,
1074            "groups": [],
1075            "content": [
1076                {
1077                    "sku": "23svvs1006",
1078                    "quantity": 1
1079                },
1080                {
1081                    "sku": "23svvs1008",
1082                    "quantity": 1
1083                },
1084                {
1085                    "sku": "11cog1021",
1086                    "quantity": 1
1087                },
1088                {
1089                    "sku": "11cog1032",
1090                    "quantity": 1
1091                }
1092            ]
1093        },
1094        {
1095            "item_id": 953087,
1096            "sku": "bndl1404v03",
1097            "type": "bundle",
1098            "name": {
1099                "en": "Clockwork Warrior\u2019s Arsenal"
1100            },
1101            "bundle_type": "standard",
1102            "description": {
1103                "en": "Equipped with powerful defenses and mechanical mastery, this bundle is ideal for mice who prefer to fight their way through dangers."
1104            },
1105            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/ead1ac351c5a4351e6e7a2bdd832f693.webp",
1106            "regional_prices": [],
1107            "prices": [
1108                {
1109                    "amount": 31,
1110                    "currency": "USD",
1111                    "is_default": true,
1112                    "is_enabled": true
1113                }
1114            ],
1115            "virtual_prices": [],
1116            "is_enabled": true,
1117            "is_show_in_store": true,
1118            "regions": [],
1119            "limits": {
1120                "per_user": null,
1121                "per_item": null,
1122                "recurrent_schedule": null
1123            },
1124            "periods": [],
1125            "attributes": [],
1126            "long_description": null,
1127            "media_list": [],
1128            "order": 3,
1129            "is_free": false,
1130            "groups": [],
1131            "content": [
1132                {
1133                    "sku": "23svvs1009",
1134                    "quantity": 1
1135                },
1136                {
1137                    "sku": "23svvs1010",
1138                    "quantity": 1
1139                },
1140                {
1141                    "sku": "11cog1041",
1142                    "quantity": 1
1143                },
1144                {
1145                    "sku": "11cog1012",
1146                    "quantity": 1
1147                }
1148            ]
1149        },
1150        {
1151            "item_id": 953089,
1152            "sku": "bndl1404v04",
1153            "type": "bundle",
1154            "name": {
1155                "en": "Master Engineer\u2019s Blueprint Bundle"
1156            },
1157            "bundle_type": "standard",
1158            "description": {
1159                "en": "A bundle made for master engineers looking to shape the world around them using the most advanced technology and resources."
1160            },
1161            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/e2e2036079229214274d2e3e488c7863.webp",
1162            "regional_prices": [],
1163            "prices": [
1164                {
1165                    "amount": 35,
1166                    "currency": "USD",
1167                    "is_default": true,
1168                    "is_enabled": true
1169                }
1170            ],
1171            "virtual_prices": [],
1172            "is_enabled": true,
1173            "is_show_in_store": true,
1174            "regions": [],
1175            "limits": {
1176                "per_user": null,
1177                "per_item": null,
1178                "recurrent_schedule": null
1179            },
1180            "periods": [],
1181            "attributes": [],
1182            "long_description": null,
1183            "media_list": [],
1184            "order": 4,
1185            "is_free": false,
1186            "groups": [],
1187            "content": [
1188                {
1189                    "sku": "23svvs1015",
1190                    "quantity": 1
1191                },
1192                {
1193                    "sku": "23svvs1013",
1194                    "quantity": 1
1195                },
1196                {
1197                    "sku": "11cog1053",
1198                    "quantity": 1
1199                },
1200                {
1201                    "sku": "11cog1043",
1202                    "quantity": 1
1203                }
1204            ]
1205        },
1206        {
1207            "item_id": 953092,
1208            "sku": "bndl1404v05",
1209            "type": "bundle",
1210            "name": {
1211                "en": "Relics of the Clockwork King"
1212            },
1213            "bundle_type": "standard",
1214            "description": {
1215                "en": "A treasure trove of rare artifacts and powerful resources, reserved for the most daring explorers of the mechanical realm."
1216            },
1217            "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/60c8af7c07a62e30d9e82778f5a12283.webp",
1218            "regional_prices": [],
1219            "prices": [
1220                {
1221                    "amount": 39,
1222                    "currency": "USD",
1223                    "is_default": true,
1224                    "is_enabled": true
1225                }
1226            ],
1227            "virtual_prices": [],
1228            "is_enabled": true,
1229            "is_show_in_store": true,
1230            "regions": [],
1231            "limits": {
1232                "per_user": null,
1233                "per_item": null,
1234                "recurrent_schedule": null
1235            },
1236            "periods": [],
1237            "attributes": [],
1238            "long_description": null,
1239            "media_list": [],
1240            "order": 5,
1241            "is_free": false,
1242            "groups": [],
1243            "content": [
1244                {
1245                    "sku": "23svvs1016",
1246                    "quantity": 1
1247                },
1248                {
1249                    "sku": "23svvs1019",
1250                    "quantity": 1
1251                },
1252                {
1253                    "sku": "11cog1033",
1254                    "quantity": 1
1255                },
1256                {
1257                    "sku": "11cog1023",
1258                    "quantity": 1
1259                }
1260            ]
1261        }
1262    ]
1263}

  1. 가져오기 창의 해당 필드에 전체 파일을 업로드합니다.
  2. 가져오는 동안 오류가 발생하면 가져오기 창에 오류 목록과 수정 권장 사항이 표시됩니다. 파일을 필요에 따라 변경한 후 다시 업로드합니다.

업로드에 성공하면 지정된 SKU를 가진 항목이 생성, 업데이트 또는 비활성화됩니다.

알림
JSON 파일을 통해 아이템 가져오기 API 호출을 사용하여 아이템을 가져올 수 있습니다.
가져오기 중 오류가 발생하지 않도록 방지하려면 위의 파일 작성 권장 사항을 따르세요.

항목 카탈로그 내보내기

아이템 또는 아이템 카탈로그를 JSON 파일로 내보내는 방법:

  1. 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 인게임 재화, 아이템 카탈로그 > 가상 아이템, 또는 아이템 카탈로그 > 번들 섹션으로 이동합니다.
  2. 아이템 내보내기를 클릭합니다 .

  1. 작업 선택:
    • 모든 항목 내보내기 - 이 프로젝트의 모든 항목 유형에 대한 전체 카탈로그를 내보냅니다. 예를 들어 인게임 재화 섹션으로 이동하여 모든 항목을 내보내면 JSON 파일로 프로젝트의 인게임 재화, 인게임 재화 패키지, 가상 아이템, 게임 키 패키지를 언로드합니다.
    • 선택한 항목만 내보내기 - 열린 창에서 내보낼 항목을 선택합니다.

  1. 내보내기를 클릭합니다.

JSON 파일 다운로드가 자동으로 시작됩니다.

이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
마지막 업데이트: 2025년 9월 19일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!
피드백을 보내는 중 문제가 발생했습니다
잠시 후 다시 시도하거나 doc_feedback@xsolla.com으로 연락해 주세요.