Katalog importieren
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.
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:
Artikelkatalog importieren
So importieren Sie einen Artikel aus einer Datei:
- Öffnen Sie das Projekt im Kundenportal.
- Klicken Sie in der Seitenleiste auf Store und dann auf Virtuelle Währung, Virtuelle Gegenstände oder 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):
- json
{
"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
}
]
}
]
}
- 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.
Artikelkatalog exportieren
So exportieren Sie einen Artikel oder den Artikelkatalog als JSON-Datei:
- Öffnen Sie das Projekt im Kundenportal.
- Klicken Sie in der Seitenleiste auf Store und dann auf Virtuelle Währung, Virtuelle Gegenstände oder 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.
Katalog aus externen Plattformen importieren
Sie können Artikel und Abonnements aus externen Plattformen importieren und das Benutzerinventar synchronisieren.
- Katalog neu importieren (außer Abonnements)
- Im Kundenportal Änderungen am Katalog manuell vornehmen
- Mithilfe der API-Methodengruppen für die Verwaltung von Bundles, virtuellen Gegenständen und Währungen, Abo-Modellen sowie Abo-Produkten Änderungen am Katalog vornehmen
Katalog aus Google Play importieren
Prüfen Sie, ob die Google Play Android Developer API in Ihrem Google Play-Projekt aktiviert ist, bevor Sie den Import starten. Besuchen Sie https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/overview?project={project_id}
, wobei project_id
Ihre Projekt-ID in Google Play ist. Falls die API deaktiviert ist, müssen Sie diese aktivieren. Es dauert eine Weile, bis die Einstellungen übernommen sind. Daher kann der Import fehlschlagen, wenn Sie sofort nach der Aktivierung versuchen, den Import zu starten. Warten Sie einige Minuten, und versuchen Sie es dann erneut.
- Öffnen Sie Ihr Projekt im Kundenportal.
- Klicken Sie im seitlichen Menü auf Online-Shop.
- Klicken Sie im Bereich Katalogverwaltung auf Konfigurieren.
- Klicken Sie im Bereich Integration in externe Plattformen auf Konfigurieren.
- Klicken Sie im Bereich Google Play auf Konfigurieren.
- Geben Sie Ihre Anwendungs-ID an – die ID Ihrer Anwendung aus Google Play.
- Laden Sie einen privaten Schlüssel als JSON hoch.
- Wechseln Sie zur Google Play Console, klicken Sie in der Seitenleiste auf Nutzer und Berechtigungen, und fügen Sie ein Dienstkonto als neuer Nutzer hinzu.
- Klicken Sie auf Speichern.
- Klicken Sie auf Import starten. Daraufhin beginnt der Katalogimport.
- Um virtuelle Gegenstände in dem über den Site Builder erstellten Web Shop zu verkaufen, konfigurieren Sie Gegenstandsgruppen im Kundenportal und weisen Sie jedem Gegenstand mindestens eine der konfigurierten Gruppen zu.
- Um die Gegenstandsbilder anzuzeigen, müssen Sie sie im Kundenportal zunächst hochladen.
Katalog aus PlayFab importieren
PlayFab bietet Spieleentwicklern fertige Serverlösungen für die Verwaltung von Katalogen und für die Monetarisierung. Nach der Integration von PlayFab können Sie einen Katalog aus PlayFab in Xsollas Store-Lösung importieren.
- Öffnen Sie Ihr Projekt im Kundenportal.
- Klicken Sie im seitlichen Menü auf Online-Shop.
- Klicken Sie im Bereich Katalogverwaltung auf Konfigurieren.
- Klicken Sie im Bereich Integration in externen Plattformen auf Konfigurieren.
- Klicken Sie im Bereich PlayFab auf Konfigurieren.
- Geben Sie auf der Registerkarte Artikelimport Folgendes an:
- Titel-ID – Projekt-ID in PlayFab.
- Geheimer Schlüssel – Schlüssel des Projekts in PlayFab.
- Klicken Sie auf Speichern.
- Synchronisieren Sie das Benutzerinventar mit PlayFab (optional):
- Wechseln Sie zur Registerkarte Inventarsynchronisierung und geben Sie Folgendes an:
- Titel-ID – Projekt-ID in PlayFab.
- Geheimer Schlüssel – Schlüssel des Projekts in PlayFab.
- Stellen Sie den Umschalter Benutzerinventar mit PlayFab synchronisieren auf Ein.
- Klicken Sie auf Speichern.
- Wechseln Sie zur Registerkarte Inventarsynchronisierung und geben Sie Folgendes an:
- Wechseln Sie zur Registerkarte Artikelimport, und klicken Sie auf Import starten. Daraufhin beginnt der Katalogimport.
- Um virtuelle Gegenstände in dem über den Site Builder erstellten Web Shop zu verkaufen, konfigurieren Sie Gegenstandsgruppen im Kundenportal und weisen Sie jedem Gegenstand mindestens eine der konfigurierten Gruppen zu.
- Um die Gegenstandsbilder anzuzeigen, müssen Sie sie im Kundenportal zunächst hochladen.
Um zu prüfen, ob der Import erfolgreich abgeschlossen wurde, wechseln Sie über das seitliche Menü zum Abschnitt Online-Shop, und stellen Sie sicher, dass Gegenstände, Währungen und Bundles auf den Registerkarten Virtuelle Währung, Virtuelle Gegenstände und Bundles aktiviert sind.
Katalog neu importieren
Wenn Sie einen Katalog neu importieren, ist Folgendes zu beachten:
- Bereits im Online-Shop befindliche Artikel werden aktualisiert.
- Noch nicht im Online-Shop befindliche Artikel werden hinzugefügt.
- Aus der Importquelle entfernte Artikel verbleiben im Online-Shop. Solche Artikel können Sie im Kundenportal oder über die API löschen.
Artikel automatisch über API erstellen
Wenn Sie eine Vielzahl von Artikeln auf der Grundlage von Daten aus Ihrem System erstellen müssen, können Sie den Vorgang mithilfe der API automatisieren.
Dazu müssen Sie:
- die Artikeldaten aus Ihrem System exportieren,
- die exportierten Daten in ein Format konvertieren, das dem Datenformat der API-Methode des gewünschten Artikeltyps entspricht,
- ein Skript erstellen, das die erforderliche API-Methode für jeden exportierten Artikel aufruft:
Wenn Sie Gegenstandsgruppen verwenden möchten, müssen Sie diese im Voraus im Kundenportal erstellen.
Wenn Sie mehrere Artikeltypen verwenden möchten, sollten diese in der folgenden Reihenfolge erstellt werden:
- Gegenstandsgruppen im Kundenportal
- virtuelle Währungen
- virtuelle Gegenstände
- virtuelle Währungspakete
- Bundles
Nachfolgend sehen Sie ein Beispielskript, das wiederholt die Methode Virtuellen Gegenstand erstellen aufruft, um virtuelle Gegenstände zu erstellen.
Das Skript wurde mit JavaScript und Node.js, der JavaScript-Laufzeitumgebung, entwickelt.
- Importieren Sie die
fetch
-Funktion des Moduls“node-fetch”
, um HTTP-Anfragen an den Xsolla-Server senden zu können.
- javascript
import fetch from "node-fetch";
- Legen Sie die für die Anfrageautorisierung benötigten Konstanten fest. Fügen Sie anstelle von
<your project_id from PA>
und<your api key from PA>
Ihre Werte für die Projekt-ID und den API-Schlüssel ein, die für die spätere Verwendung in API-Anfragen mit Base64 kodiert werden.
- javascript
const projectId = <your project_id from PA>;
const apiKey = <your api key from PA>;
const buff = new Buffer(`${projectId}:${apiKey}`);
const basicAuth = buff.toString('base64')
- Implementieren Sie die Hilfsfunktion
sleep
. Diese dient dazu, das Senden von Anfragen zu verzögern. Das ist notwendig, um die Ratenbegrenzung bei API-Anfragen nicht zu überschreiten.
- javascript
function sleep(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
- Implementieren Sie die Funktion
getItems
, um Artikeldaten aus Ihrem System abzurufen.
- javascript
async function getItems() {
// receive items from the original system or read from a pre-prepared file
return items;
}
- Implementieren Sie die für Ihr System spezifische Funktion
prepareData
, um die Artikeldaten gemäß dem erforderlichen Datenformat des API-Aufrufs Virtuellen Gegenstand erstellen zu formatieren.
- javascript
function prepareData(items) {
// format items in accordance with API requirements
return formattedItems;
}
- Ergänzen Sie die Funktion
createItem
. Diese Funktion sendet einePOST
-Anfrage an die Xsolla-API, um einen virtuellen Gegenstand zu erstellen.
- javascript
async function createItem(item) {
const url = `https://store.xsolla.com/api/v2/project/${projectId}/admin/items/virtual_items`;
return await fetch(url, {
method: "POST",
headers: {
Authorization: "Basic " + basicAuth,
"Content-Type": "application/json"
},
body: JSON.stringify(item),
});
}
- Ergänzen Sie die Funktion
checkItemExist
, um zu prüfen, ob ein virtueller Gegenstand mit der angegebenen SKU existiert. Die Funktion sendet eineGET
-Anfrage an die Xsolla-API:- Enthält die Antwort den HTTP-Statuscode
404
, wurde der Gegenstand mit der angegebenen SKU nicht gefunden und muss erstellt werden. - Enthält die Antwort den HTTP-Statuscode
200
, wurde der Gegenstand mit der angegebenen SKU gefunden und muss nicht erstellt werden.
- Enthält die Antwort den HTTP-Statuscode
- javascript
async function checkItemExist(sku) {
const url = `https://store.xsolla.com/api/v2/project/${projectId}/admin/items/virtual_items/sku/${sku}`;
const response = await fetch(url, {
method: "GET",
headers: {
Authorization: "Basic " + basicAuth
}
});
return response.status !== 404;
}
- Ergänzen Sie die Funktion
createItems
, die die Liste der Gegenstände durchgeht und prüft, ob es aufseiten von Xsolla einen Gegenstand mit einer SKU aus Ihrem System gibt. Wurde kein Gegenstand mit einer solchen SKU gefunden, erstellt die Funktion einen Gegenstand. Der Fortschritt wird in der Konsole angezeigt.
- javascript
async function createItems(items) {
let success = 0;
let alreadyCreated = 0;
for (let i = 0; i < items.length; i++) {
const item = items[i];
if (item['sku'] === undefined) {
console.log(`${i} Field "sku" not specified`);
continue;
}
const sku = item['sku'];
if (await checkItemExist(sku)) {
console.log(`${i} Item with sku "${sku}" already created`);
alreadyCreated++;
continue;
}
const response = await createItem(item);
if (response.status === 201) {
console.log(`${i} Item with sku "${sku}" successfully created`)
success++;
} else {
const jsonData = await response.json();
console.log(`${i} An error occurred while creating the items with sku "${sku}"`);
console.log(jsonData);
}
// add a delay so as not to run into rate limits
await sleep(500);
}
console.log(`${success} items out of ${items.length} created. ${alreadyCreated} items already existed`);
}
- Ergänzen Sie die Funktion
run
. Diese Funktion ruft alle oben genannten Funktionen in der richtigen Reihenfolge auf.
- javascript
async function run() {
const items = await getItems();
const formattedItems = prepareData(items);
await createItems(formattedItems);
}
Der vollständige Code:
- javascript
import fetch from "node-fetch";
const projectId = <your project_id from PA>;
const apiKey = <your api key from PA>;
const buff = new Buffer(`${projectId}:${apiKey}`);
const basicAuth = buff.toString('base64')
function sleep(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
async function getItems() {
// receive items from the original system or read from a pre-prepared file
return items;
}
function prepareData(items) {
// format items in accordance with API requirements
return formatedItems;
}
async function createItem(item) {
const url = `https://store.xsolla.com/api/v2/project/${projectId}/admin/items/virtual_items`;
return await fetch(url, {
method: "POST",
headers: {
Authorization: "Basic " + basicAuth,
"Content-Type": "application/json"
},
body: JSON.stringify(item),
});
}
async function isItemExisted(sku) {
const url = `https://store.xsolla.com/api/v2/project/${projectId}/admin/items/virtual_items/sku/${sku}`;
const response = await fetch(url, {
method: "GET",
headers: {
Authorization: "Basic " + basicAuth
}
});
return response.status !== 404;
}
async function createItems(items) {
let success = 0;
let alreadyCreated = 0;
for (let i = 0; i < items.length; i++) {
const item = items[i];
if (item['sku'] === undefined) {
console.log(`${i} Field "sku" not specified`);
continue;
}
const sku = item['sku'];
if (await isItemExisted(sku)) {
console.log(`${i} Item with sku "${sku}" already created`);
alreadyCreated++;
continue;
}
const response = await createItem(item);
if (response.status === 201) {
console.log(`${i} Item with sku "${sku}" successfully created`)
success++;
} else {
const jsonData = await response.json();
console.log(`${i} An error occurred while creating the items with sku "${sku}"`);
console.log(jsonData);
}
// add a delay so as not to run into rate limits
await sleep(500);
}
console.log(`${success} items out of ${items.length} created. ${alreadyCreated} items already existed`);
}
async function run() {
const items = await getItems();
const formattedItems = prepareData(items);
await createItems(formattedItems);
}
run();
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.