So erstellen und aktualisieren Sie einen Artikelkatalog durch einen JSON-Import
Sie können Artikel aus einer JSON-Datei importieren und so die Artikel erstellen, aktualisieren oder deaktivieren.
Hinweis
Sie können Artikel durch API-Aufrufe oder manuell im Kundenportal erstellen, aktualisieren oder deaktivieren. Allerdings müssen Sie für jeden Artikel eine separate Anfrage stellen oder Aktion durchführen. Beim Import können Sie diese Aktionen für mehrere Artikel gleichzeitig durchführen, indem Sie die Artikel in einer einzigen JSON-Datei angeben.
Dadurch können Sie:
Merkmale:
- Unterstützung für die folgenden Artikeltypen:
- virtuelle Gegenstände
- virtuelle Währung
- virtuelle Währungspakete
- Bundles
- Datenüberprüfung. Wenn die Dateistruktur oder das Datenformat den Anforderungen nicht entspricht, wird beim Importieren eine Liste mit Fehlern angezeigt.
Einschränkungen:
- Der Import von Spielschlüsseln, Werbeaktionen und Belohnungssystemen ist nicht möglich.
- Die Größe der hochgeladenen JSON-Datei darf maximal 7 MB betragen.
- Das Parameterformat in der JSON-Datei muss mit dem Format übereinstimmen, das in der entsprechenden Artikelerstellungsmethode angegeben ist:
Hinweis
Für vorab erstellte Artikel können Sie regionale Preise aus einer CSV-Datei importieren.
Artikelkatalog importieren
So importieren Sie einen Artikelkatalog aus einer Datei:
- Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Artikelkatalog > Virtuelle Währung, Artikelkatalog > Virtuelle Gegenstände oder Artikelkatalog > Bundles.
- Klicken Sie auf Artikel importieren.
- Wählen Sie eine Aktion:
- Neue Artikel hinzufügen – nur Artikel mit neuen SKUs werden hinzugefügt.
- Neue Artikel hinzufügen und vorhandene Artikel aktualisieren – Artikel mit neuen SKUs werden hinzugefügt und die Daten vorhandener Artikel werden aktualisiert.
- Neue Artikel hinzufügen, vorhandene Artikel aktualisieren und fehlende Artikel deaktivieren – Artikel mit SKUs aus der Datei werden hinzugefügt/aktualisiert. Wenn ein Artikel im Katalog vorhanden ist, aber keine SKU in der Datei hinterlegt ist, wird der Status des Artikels im Kundenportal in Teilweise verfügbar geändert, d. h., der Artikel kann nicht einzeln gekauft werden, ist aber als Teil eines Bundles oder eines Bonus erhältlich.
- Vervollständigen Sie die Datei für den Import:
- Laden Sie die Dateivorlage im Download-Fenster herunter und vervollständigen Sie diese gemäß dem unten stehenden Beispiel.
- Exportieren Sie die Artikel und verwenden Sie die exportierte Datei als Vorlage.
- Erstellen Sie Ihre eigene JSON-Datei und vervollständigen Sie diese gemäß dem unten stehenden Beispiel.
Vervollständigte JSON-Datei (Beispie):
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}
- Laden Sie die vervollständigte Datei in das entsprechende Feld im Importfenster hoch.
- Wenn beim Import Fehler auftreten, wird im Importfenster eine Liste dieser Fehler mitsamt Korrekturmaßnahmen angezeigt. Nehmen Sie die erforderlichen Änderungen an der Datei vor, und laden Sie diese erneut hoch.
Nach erfolgreichem Upload werden die Artikel mit den angegebenen SKUs erstellt, aktualisiert oder deaktiviert.
Hinweis
Mithilfe des API-Aufrufs Artikel aus JSON-Datei importieren können Sie Artikel importieren.
Befolgen Sie die obigen Empfehlungen zum Ausfüllen der Datei, um Fehler beim Import zu vermeiden.
Befolgen Sie die obigen Empfehlungen zum Ausfüllen der Datei, um Fehler beim Import zu vermeiden.
Artikelkatalog exportieren
So exportieren Sie einen Artikel oder den Artikelkatalog als JSON-Datei:
- Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Artikelkatalog > Virtuelle Währung, Artikelkatalog > Virtuelle Gegenstände oder Artikelkatalog > Bundles.
- Klicken Sie auf Artikel exportieren.
- Wählen Sie eine Aktion:
- Alle Artikel exportieren – der gesamte Katalog mit allen Projektartikeln wird exportiert. Wenn Sie zum Beispiel zum Abschnitt Virtuelle Währung navigieren und alle Artikel exportieren, werden die virtuellen Währungen, die virtuellen Währungspakete, die virtuellen Gegenstände und die Spielschlüsselpakete des Projekts in die JSON-Datei geschrieben.
- Nur ausgewählte Artikel exportieren – wählen Sie in dem sich öffnenden Fenster die zu exportierenden Artikel aus.
- Klicken Sie auf Exportieren.
Daraufhin startet automatisch der Download der JSON-Datei.
War dieser Artikel hilfreich?
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.
