Como criar e atualizar um catálogo de itens usando a importação por JSON
Você pode criar, atualizar ou desativar itens usando através da importação de um arquivo JSON.
Observação
Você pode criar, atualizar ou desativar itens usando chamadas API ou manualmente na Conta de Distribuidor. Porém, para cada item, você precisa desempenhar uma solicitação ou ação separada. Com a importação, você pode realizar essas ações para múltiplos itens simultaneamente especificando-os em um único arquivo JSON.
Com essa ferramenta, você pode:
Recursos:
- Suporte para os seguintes tipos de itens:
- itens virtuais
- moedas virtuais
- pacotes de moedas virtuais
- conjuntos
- Validação de dados. Se a estrutura do arquivo ou formato de dados não cumprir os requisitos, você verá uma lista de erros ao importar.
Limitações:
- A importação não está disponível para chaves de jogos, promoções e o sistema de recompensas.
- O tamanho do arquivo JSON não deve exceder 7 MB.
- O formato do parâmetro no arquivo JSON deve corresponder ao formato especificado no método de criação do produto correspondente:
Observação
Para itens pré-criados, você pode importar preços regionais de um arquivo CSV:
Importação do catálogo de itens
Para importar um catálogo de itens de um arquivo:
- Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > Virtual currency, Items catalog > Virtual items ou Items catalog > Bundles.
- Selecione Import items.
- Escolha uma ação:
- Add new items — apenas itens com SKUs novos serão adicionados.
- Add new items and update existing ones — itens com SKUs novos serão adicionados e os dados de itens existentes serão atualizados.
- Add new, update existing, disable missing items — itens com SKUs do arquivo serão adicionados/atualizados. Se houver um item no catálogo, mas não houver tal SKU no arquivo, o status do item na Conta de Distribuidor será alterado para Partially available — o item não pode ser comprado separadamente, mas está disponível como parte de um conjunto ou bônus.
- Preencha o arquivo para importação:
- Baixe o modelo de arquivo na janela de download e preencha-o de acordo com o exemplo abaixo.
- Exporte os itens e use o arquivo exportado como modelo.
- Crie seu próprio arquivo JSON e preencha-o de acordo com o exemplo abaixo.
Um exemplo de um arquivo JSON completo:
Copy
- json
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}
- Envie o arquivo completo ao campo correspondente na janela de importação.
- Se houver erros durante a importação, uma lista desses erros e recomendações para a correção deles será exibida na janela de importação. Faça as alterações necessárias ao arquivo e envie-o novamente.
Após um envio bem-sucedido, os itens com os SKUs especificados serão criados, atualizados ou desativados.
Observação
Você pode importar itens usando a chamada de API Importação de itens por arquivo JSON.
Para evitar erros durante a importação, siga as recomendações acima para preencher o arquivo.
Para evitar erros durante a importação, siga as recomendações acima para preencher o arquivo.
Exportação do catálogo de itens
Para exportar um item ou catálogo de itens a um arquivo JSON:
- Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > Virtual currency, Items catalog > Virtual items ou Items catalog > Bundles.
- Selecione Export items.
- Escolha a ação:
- Export all items — o catálogo inteiro de todos os tipos de itens deste projeto será exportado. Por exemplo, se você navegar para a seção Virtual Currency e exportar todos os itens, o arquivo JSON descarregará as moedas virtuais, pacotes de moedas virtuais, itens virtuais e pacotes de chaves de jogo do seu projeto.
- Export only selected items — na janela aberta, selecione os itens que devem ser exportados.
- Clique em Export.
O download do arquivo JSON começará automaticamente.
Este artigo foi útil?
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.
