JSON 가져오기를 사용하여 항목 카탈로그를 생성하고 업데이트하는 방법
JSON 파일에서 가져오기를 사용하여 항목을 생성, 업데이트 또는 비활성화할 수 있습니다.
알림
API 호출 또는 관리자 페이지에서 수동으로 항목을 생성, 업데이트 또는 비활성화할 수 있습니다. 단, 각 항목에 대해 별도의 요청 또는 작업을 수행해야 합니다. 가져오기를 사용하면 단일 JSON 파일에 지정하여 여러 항목에 대해 이러한 작업을 동시에 수행할 수 있습니다.
이 도구로 할 수 있는 작업:
특징:
- 다음 유형의 항목 지원:
- 가상 아이템
- 인게임 재화
- 인게임 재화 패키지
- 번들
- 데이터 유효성 검사. 파일 구조나 데이터 형식이 요구 사항을 충족하지 않으면 가져올 때 오류 목록이 표시됩니다.
제한 사항:
- 게임 키, 프로모션, 보상 시스템에서는 가져오기를 사용할 수 없습니다.
- 업로드된 JSON 파일의 크기는 7MB를 초과할 수 없습니다.
- JSON 파일의 매개 변수 형식은 해당 상품 생성 방법에 지정된 형식과 일치해야 합니다.
알림
미리 생성된 항목의 경우 CSV 파일에서 지역 가격을 가져오기를 수행할 수 있습니다.
항목 카탈로그 가져오기
파일에서 아이템 카탈로그를 가져오는 방법:
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 인게임 재화, 아이템 카탈로그 > 가상 아이템, 또는 아이템 카탈로그 > 번들 섹션으로 이동합니다.
- 아이템 가져오기를 클릭합니다 .
- 작업 선택 :
- 새 항목 추가 - 새 SKU가 있는 항목만 추가됩니다.
- 새 항목 추가 및 기존 항목 업데이트 - 새 SKU가 있는 항목이 추가되고 기존 항목의 데이터가 업데이트됩니다.
- 새 항목 추가, 기존 항목 업데이트, 누락 항목 비활성화 - 파일에서 SKU가 있는 항목이 추가/업데이트됩니다. 카탈로그에는 항목이 있지만 파일에 해당 SKU가 없는 경우 관리자 페이지에서 항목 상태가 부분적으로 사용 가능으로 표시되며, 이 경우 항목을 별도로 구매할 수 없지만 번들 또는 보너스의 일부로 사용할 수 있습니다.
- 가져올 파일 작성하기:
- 다운로드 창에서 파일 템플릿을 다운로드하고 아래 예시에 따라 파일을 작성합니다.
- 항목을 내보내고 내보낸 파일을 템플릿으로 사용합니다.
- 자체 JSON 파일을 생성하여 아래 예시에 따라 작성합니다.
전체 JSON 파일의 예시:
Copy
- json
1{
2 "virtual_currency": [
3 {
4 "sku": "Gem_test_import",
5 "name": {
6 "en": "Gem_test_import"
7 },
8 "type": "virtual_currency",
9 "description": {
10 "en": "my test imported currency"
11 },
12 "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
13 "description": {
14 "en": "my test imported currency",
15 "de": "meine importierte Testwährung"
16 },
17 "attributes": [],
18 "is_free": false,
19 "order": 1,
20 "groups": [],
21 "regional_prices": [],
22 "prices": [
23 {
24 "amount": 2,
25 "currency": "USD",
26 "is_default": true,
27 "is_enabled": true
28 }
29 ],
30 "media_list": [],
31 "vc_prices": [],
32 "is_enabled": true,
33 "is_show_in_store": true,
34 "regions": [],
35 "limits": {
36 "per_user": null,
37 "per_item": null,
38 "recurrent_schedule": null
39 },
40 "periods": [],
41 "inventory_options": {
42 "consumable": true,
43 "expiration_period": null
44 },
45 "is_hard": false
46 }
47 ],
48 "virtual_items": [
49 {
50 "sku": "event_access_test_import",
51 "name": {
52 "en": "Special Event Access_test_import"
53 },
54 "type": "virtual_good",
55 "description": {
56 "en": "Get special event access as a bonus only on your first purchase. Find the right doggy at the Robo-Dog Exhibition!"
57 },
58 "image_url": "https://cdn3.xsolla.com/img/misc/images/1e3ef1a96cc9dd8d98bc124d5d6fad79.png",
59 "long_description": null,
60 "attributes": [],
61 "is_free": false,
62 "order": 1,
63 "groups": [
64 "my_test_group"
65 ],
66 "regional_prices": [],
67 "prices": [
68 {
69 "amount": 35,
70 "currency": "USD",
71 "is_default": true,
72 "is_enabled": true
73 }
74 ],
75 "media_list": [],
76 "vc_prices": [],
77 "is_enabled": true,
78 "is_show_in_store": true,
79 "regions": [],
80 "limits": {
81 "per_user": null,
82 "per_item": null,
83 "recurrent_schedule": null
84 },
85 "periods": [],
86 "inventory_options": {
87 "consumable": true,
88 "expiration_period": null
89 }
90 }
91 ],
92 "virtual_currency_packages": [
93 {
94 "item_id": 441982,
95 "sku": "small_gold_pack_test_import",
96 "type": "bundle",
97 "name": {
98 "en": "Small gold pack"
99 },
100 "bundle_type": "virtual_currency_package",
101 "description": {
102 "en": "Gold x100"
103 },
104 "image_url": "https://cdn3.xsolla.com/img/misc/images/ba43c46ea75fd5713c210f5736993a92.png",
105 "vc_prices": [],
106 "regional_prices": [],
107 "prices": [
108 {
109 "amount": 5,
110 "currency": "USD",
111 "is_default": true,
112 "is_enabled": true
113 }
114 ],
115 "is_enabled": true,
116 "is_show_in_store": true,
117 "regions": [],
118 "limits": {
119 "per_user": null,
120 "per_item": null,
121 "recurrent_schedule": null
122 },
123 "periods": [],
124 "attributes": [],
125 "long_description": null,
126 "media_list": [],
127 "order": 100000000,
128 "is_free": false,
129 "groups": [],
130 "content": [
131 {
132 "sku": "Gem_test_import",
133 "quantity": 100
134 }
135 ]
136 }
137 ],
138 "bundles": [
139 {
140 "item_id": 684024,
141 "sku": "start_pack_test_import_test_import",
142 "type": "bundle",
143 "name": {
144 "en": "Legendary Start Pack"
145 },
146 "bundle_type": "standard",
147 "description": {
148 "en": "Crystal x 1\nGem x 1"
149 },
150 "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
151 "regional_prices": [],
152 "prices": [
153 {
154 "amount": 20,
155 "currency": "USD",
156 "is_default": true,
157 "is_enabled": true
158 }
159 ],
160 "virtual_prices": [],
161 "is_enabled": true,
162 "is_show_in_store": true,
163 "regions": [],
164 "limits": {
165 "per_user": null,
166 "per_item": null,
167 "recurrent_schedule": null
168 },
169 "periods": [],
170 "attributes": [],
171 "long_description": null,
172 "media_list": [],
173 "order": 5,
174 "is_free": false,
175 "groups": [
176 "my_test_group"
177 ],
178 "content": [
179 {
180 "sku": "Gem_test_import",
181 "quantity": 1
182 },
183 {
184 "sku": "event_access_test_import",
185 "quantity": 1
186 }
187 ]
188 }
189 ]
190}
- 가져오기 창의 해당 필드에 전체 파일을 업로드합니다.
- 가져오는 동안 오류가 발생하면 가져오기 창에 오류 목록과 수정 권장 사항이 표시됩니다. 파일을 필요에 따라 변경한 후 다시 업로드합니다.
업로드에 성공하면 지정된 SKU를 가진 항목이 생성, 업데이트 또는 비활성화됩니다.
알림
JSON 파일을 통해 아이템 가져오기 API 호출을 사용하여 아이템을 가져올 수 있습니다.
가져오기 중 오류가 발생하지 않도록 방지하려면 위의 파일 작성 권장 사항을 따르세요.
가져오기 중 오류가 발생하지 않도록 방지하려면 위의 파일 작성 권장 사항을 따르세요.
항목 카탈로그 내보내기
아이템 또는 아이템 카탈로그를 JSON 파일로 내보내는 방법:
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 인게임 재화, 아이템 카탈로그 > 가상 아이템, 또는 아이템 카탈로그 > 번들 섹션으로 이동합니다.
- 아이템 내보내기를 클릭합니다 .
- 작업 선택:
- 모든 항목 내보내기 - 이 프로젝트의 모든 항목 유형에 대한 전체 카탈로그를 내보냅니다. 예를 들어 인게임 재화 섹션으로 이동하여 모든 항목을 내보내면 JSON 파일로 프로젝트의 인게임 재화, 인게임 재화 패키지, 가상 아이템, 게임 키 패키지를 언로드합니다.
- 선택한 항목만 내보내기 - 열린 창에서 내보낼 항목을 선택합니다.
- 내보내기를 클릭합니다.
JSON 파일 다운로드가 자동으로 시작됩니다.
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
