Cómo se crea y actualiza un catálogo de artículos empleando la importación de JSON
Puede crear, actualizar o desactivar artículos utilizando la importación desde un archivo JSON.
Nota
Puede crear, actualizar o desactivar artículos mediante llamadas API o manualmente en Cuenta del editor. No obstante, para cada artículo debe realizar una solicitud o acción independiente. Con la importación, puede ejecutar estas acciones para varios artículos simultáneamente, especificándolos en un único archivo JSON.
Con esta herramienta, puede hacer lo siguiente:
Características:
- Compatibilidad con los siguientes tipos de artículos:
- artículos virtuales
- moneda virtual
- paquetes de moneda virtual
- lotes
- Validación de datos. Si la estructura del archivo o el formato de datos no cumple los requisitos, podrá ver una lista de errores al hacer la importación.
Limitaciones:
- La importación no está disponible para claves del juego, promociones y sistemas de recompensas.
- El tamaño del archivo JSON cargado no debe superar los 7 MB.
- El formato de los parámetros presentes en el archivo JSON debe coincidir con el formato especificado en el correspondiente método de creación de productos:
Nota
Para los artículos previamente creados, puede importar precios regionales desde un archivo CSV.
Importación del catálogo de artículos
Para importar un catálogo de artículos de un archivo:
- Abra su proyecto en Cuenta del editor y vaya a Items catalog > Virtual currency, Items catalog > Virtual items o Items catalog > Bundles.
- Haga clic en Import items.
- Escoja la acción:
- Agregar nuevos artículos - solamente se agregarán artículos con nuevos códigos de artículo (SKU).
- Agregar nuevos artículos y actualizar los existentes - se agregarán artículos con nuevos SKU y se actualizarán los datos de los artículos existentes.
- Agregar los nuevos, actualizar los existentes, deshabilitar los artículos que faltan - se agregarán/actualizarán los artículos con SKU del archivo. Si hay un artículo en el catálogo, pero no existe el correspondiente SKU en el archivo, el estado del artículo en Cuenta del editor cambiará a Partially available - el artículo no puede comprarse por separado, pero está disponible como parte de un lote o bonificación.
- Rellene el archivo para la importación:
- Descargue la plantilla del archivo en la ventana de descargas y rellénela siguiendo el ejemplo que aparece a continuación.
- Exporte los elementos y utilice el archivo exportado como plantilla.
- Cree su propio archivo JSON y rellénelo según el ejemplo que aparece abajo.
Un ejemplo de archivo JSON completo:
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}
- Cargue el archivo completo en el campo correspondiente de la ventana de importación.
- Si ocurre algún error durante la importación, en la ventana de importación aparecerá una lista con estos errores y recomendaciones para su corrección. Haga los cambios necesarios en el archivo y cárguelo de nuevo.
Tras cargarlo correctamente, se crearán, actualizarán o desactivarán los artículos con los códigos de artículo (SKU) especificados.
Nota
Puede importar artículos utilizando la llamada API Importar artículos mediante un archivo JSON.
Para evitar errores durante la importación, siga las recomendaciones anteriores para rellenar el archivo.
Para evitar errores durante la importación, siga las recomendaciones anteriores para rellenar el archivo.
Exportación del catálogo de artículos
Para exportar un artículo o catálogo de artículos a un archivo JSON:
- Abra su proyecto en Cuenta del editor y vaya a Items catalog > Virtual currency, Items catalog > Virtual items o Items catalog > Bundles.
- Haga clic en Export items.
- Elija la acción:
- Export all items: se exportará todo el catálogo de todos los tipos de artículos de este proyecto. Por ejemplo, si navega a la sección Virtual Currency y exporte todos los artículos, el archivo JSON descargará monedas virtuales, paquetes de moneda virtual, artículos virtuales, paquetes de claves del juego de su proyecto.
- Export only selected items: en la ventana abierta, seleccione los artículos que deben exportarse.
- Haga clic en Export.
La descarga del archivo JSON se iniciará de forma automática.
¿Te ha resultado útil este artículo?
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.
