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

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

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

이 도구로 할 수 있는 작업:

특징:

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

제한 사항:

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

항목 카탈로그 가져오기

파일에서 항목 카탈로그를 가져오는 방법:

  1. 관리자 페이지에서 프로젝트를 엽니다.
  2. 사이드 메뉴에서 스토어를 클릭하고 인게임 재화, 가상 아이템 또는 번들 섹션으로 이동합니다.
  3. 항목 가져오기를 클릭합니다.

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

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

전체 JSON 파일의 예시:

Copy
Full screen
Small screen

{
    "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
                }
            ]
        }
    ]
}

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

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

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

항목 카탈로그 내보내기

항목 또는 항목 카탈로그를 JSON 파일로 내보내는 방법:

  1. 관리자 페이지에서 프로젝트를 엽니다.
  2. 사이드 메뉴에서 스토어를 클릭하고 인게임 재화, 가상 아이템 또는 번들 섹션으로 이동합니다.
  3. 항목 내보내기를 클릭합니다.

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

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

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

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

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

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!