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:

Hinweis
Für vorab erstellte Artikel können Sie regionale Preise aus einer CSV-Datei importieren.

So importieren Sie einen Artikel aus einer Datei:

  1. Öffnen Sie das Projekt im Kundenportal.
  2. Klicken Sie in der Seitenleiste auf Store und dann auf Virtuelle Währung, Virtuelle Gegenstände oder Bundles.
  3. Klicken Sie auf Artikel importieren.

  1. 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.

  1. 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
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. Laden Sie die vervollständigte Datei in das entsprechende Feld im Importfenster hoch.
  2. 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.

War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Diese Seite bewerten
Diese Seite bewerten
Gibt es etwas, das wir verbessern können?

Jetzt nicht

Vielen Dank für Ihr Feedback!
Letztmalig aktualisiert: 31. Mai 2024

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!