# Spieleliste abrufen Ruft eine Spieleliste zum Erstellen eines Katalogs ab. Achtung Bei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie in der Antwort erhalten können. Der Standard- und Höchstwert beträgt 50 Artikel pro Antwort. Um pro Seite mehr Daten zu erhalten, verwenden Sie die Felder limit und offset. Hinweis Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er ohne Autorisierung verwendet wird. Verwenden Sie die Autorisierung, um personalisierte Nutzerdaten abzurufen, wie z. B. mit dem Artikel verknüpfte Limits und Werbeaktionen. Dazu müssen Sie den Benutzer-JWT im Authorization-Header übermitteln. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit für diesen Aufruf. Endpoint: GET /v2/project/{project_id}/items/game Version: 2.0.0 Security: XsollaLoginUserJWT ## Path parameters: - `project_id` (integer, required) Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt sowie in der Adressleiste des Browsers, wenn Sie im Kundenportal ein Projekt geöffnet haben. Die URL hat das folgende Format: https://publisher.xsolla.com//projects/. Example: 44056 ## Query parameters: - `limit` (integer) Begrenzung der Elementanzahl auf der Seite. Example: 50 - `offset` (integer) Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0). - `locale` (string) Antwortsprache. Sprachencode bestehend aus zwei Kleinbuchstaben gemäß ISO 639-1 (zum Beispiel en). Fünfstellige Gebietsschemacodes (zum Beispiel en-US) werden in Lokalisierungsfeldern wie name und description unterstützt, jedoch in den Antworten in zweistellige Codes umgewandelt. Die vollständige Liste der unterstützten Sprachen finden Sie in der Dokumentation. - `additional_fields[]` (array) Zusätzliche Felder, die in die Antwort aufgenommen werden sollen. Standardmäßig werden diese Felder nicht zurückgegeben. Übermitteln Sie die erforderlichen Werte, um sie einzubeziehen. Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group" - `country` (string) Zweistelliger Ländercode in Großbuchstaben gemäß ISO 3166-1 Alpha-2. Weitere Informationen zu den von Xsolla unterstützten Ländern und dazu, wie das Land ermittelt wird, finden Sie in der Dokumentation. Example: "US" - `promo_code` (string) Eindeutiger Code, es wird zwischen Groß- und Kleinschreibung unterschieden. Enthält Buchstaben und Ziffern. Example: "WINTER2021" - `show_inactive_time_limited_items` (integer) Zeigt zeitlich begrenzte Artikel an, die nicht erhältlich sind. Der Gültigkeitszeitraum dieser Artikel hat noch nicht begonnen oder ist bereits vorüber. Example: 1 ## Response 200 fields (application/json): - `has_more` (boolean) Dient als Indikator dafür, dass weitere Seiten vorhanden sind. - `items` (array) Example: [{"sku":"com.xsolla.game_1","name":"Game name","groups":[{"external_id":"all","name":"All games"},{"external_id":"Xsolla","name":"Xsolla games"}],"type":"unit","unit_type":"game","description":"Game description","image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","attributes":[{"external_id":"genre","name":"Genre","values":[{"external_id":"23fda05111c125608af8f1fa0e99db45a10ea1cc","value":"Horror"}]}],"promotions":[],"unit_items":[{"sku":"com.xsolla.game_key_01","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_1","has_keys":true,"is_pre_order":true,"release_date":"2020-08-11T10:00:00+03:00","promotions":[],"periods":[{"date_from":"2020-08-11T10:00:00+03:00","date_until":"2020-08-11T20:00:00+03:00"}]},{"sku":"com.xsolla.game_key_02","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"can_be_bought":true,"drm_name":"Origin","drm_sku":"origin_key_1","has_keys":false,"is_pre_order":false,"release_date":null,"promotions":[],"periods":[]}]},{"sku":"com.xsolla.game_2","name":"Game name","groups":[{"external_id":"all","name":"All games"}],"type":"unit","unit_type":"game","description":"Game description","image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","attributes":[{"external_id":"OS","name":"OS","values":[{"external_id":"9d5c5efb7c0f00a00fe4e3583f1215b0050bc723","value":"Windows"}]}],"promotions":[],"unit_items":[{"sku":"com.xsolla.game_key_01","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_2","has_keys":false,"is_pre_order":false,"release_date":null,"promotions":[],"periods":[{"date_from":null,"date_until":"2020-08-11T20:00:00+03:00"}]}]}] - `items.sku` (string) Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten. Example: "game_01" - `items.name` (string) Artikelname. Example: "Game name" - `items.groups` (array) Gruppen, zu denen der Artikel gehört. - `items.groups.external_id` (string) Bei der Erstellung angegebene [Externe Artikelgruppen-ID](/de/api/catalog/item-groups-admin/admin-create-item-group#item-groups-admin/admin-create-item-group/t=request&path=external_id). Example: "exclusive" - `items.groups.name` (string) Name der Gruppe. Example: "Exclusive" - `items.groups.item_order_in_group` (integer) Die Position des Artikels innerhalb der Gruppe, die dazu dient, die Anzeigereihenfolge festzulegen. Sie wird nur dann zurückgegeben, wenn sie über den Abfrageparameter additional_fields[] angefordert wird. Example: 1 - `items.attributes` (array) Liste der Attribute und ihrer Werte, die dem Artikel zugeordnet sind. Kann für die Katalogfilterung verwendet werden. - `items.attributes.external_id` (string) Eindeutige Attribut-ID. Die external_id darf nur lateinische Klein- und Großbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten. - `items.attributes.name` (string) Name des Attributs. Example: "Genre" - `items.attributes.values` (array) - `items.attributes.values.external_id` (string) Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten. - `items.attributes.values.value` (string) Wert des Attributs. Example: "Strategy" - `items.type` (string) Artikeltyp: virtual_good/virtual_currency/bundle/physical_good/unit. Example: "unit" - `items.unit_type` (string) Einheitstyp: game. Example: "game" - `items.description` (string) Artikelbeschreibung. Example: "Game description" - `items.image_url` (string) Bild-URL. Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png" - `items.promotions` (array) Auf bestimmte Artikel im Warenkorb angewandte Werbeaktionen. Das array wird in den folgenden Fällen zurückgegeben: * Für einen bestimmten Artikel ist eine Rabattaktion konfiguriert. * Ein Promocode mit der Einstellung Rabatt auf ausgewählte Artikel ist angewandt. Werden keine Werbeaktionen auf Artikelebene angewandt, wird ein leeres Array zurückgegeben. - `items.promotions.name` (string) - `items.promotions.date_start` (string,null) - `items.promotions.date_end` (string,null) - `items.promotions.discount` (object,null) - `items.promotions.discount.percent` (string,null) - `items.promotions.discount.value` (string,null) - `items.promotions.bonus` (array) - `items.promotions.bonus.sku` (string) - `items.promotions.bonus.quantity` (integer) - `items.promotions.bonus.type` (string) Typ des Bonusartikels. Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft" - `items.promotions.bonus.name` (string) Name des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good. - `items.promotions.bonus.image_url` (string) Bild-URL des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good. - `items.promotions.bonus.bundle_type` (string) Typ des im Bundle enthaltenen Bonusartikels. Nur verfügbar für Bonusartikel vom Typ bundle. Enum: "standard", "virtual_currency_package" - `items.promotions.limits` (object) - `items.promotions.limits.per_user` (object) - `items.promotions.limits.per_user.available` (integer) - `items.promotions.limits.per_user.total` (integer) - `items.unit_items` (array) - `items.unit_items.sku` (string) Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten. Example: "game_01" - `items.unit_items.type` (string) Artikeltyp: game_key. Example: "game_key" - `items.unit_items.is_free` (boolean) Ob der Artikel kostenlos ist. - `items.unit_items.price` (object) Artikelpreise. - `items.unit_items.price.amount` (string) Reduzierter Artikelpreis. Example: "2.9900" - `items.unit_items.price.amount_without_discount` (string) Artikelpreis. Example: "2.9900" - `items.unit_items.price.currency` (string) Währung des Artikelpreises. Dreistelliger Code pro [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Example: "USD" - `items.unit_items.virtual_prices` (array) Virtuelle Preise. - `items.unit_items.virtual_prices.amount` (integer) Artikelpreis in virtueller Währung. Example: 100 - `items.unit_items.virtual_prices.amount_without_discount` (integer) Der Artikelpreis in virtueller Währung ohne Rabatt. Immer gleich amount, da Rabatte nicht auf Preise in virtueller Währung angewendet werden. Example: 200 - `items.unit_items.virtual_prices.sku` (string) SKU der virtuellen Währung. Example: "vc_gold" - `items.unit_items.virtual_prices.is_default` (boolean) Ob es sich um den Standardpreis in virtueller Währung handelt. Example: true - `items.unit_items.virtual_prices.image_url` (string,null) Bild-URL der virtuellen Währung. Example: "http://image.png" - `items.unit_items.virtual_prices.name` (string) Name der virtuellen Währung. Example: "Gold" - `items.unit_items.virtual_prices.type` (string) Artikeltyp. Für die virtuelle Währung ist es virtual_currency. Example: "virtual_currency" - `items.unit_items.virtual_prices.description` (string,null) Beschreibung der virtuellen Währung. Example: "In-game currency used to purchase weapons and upgrades" - `items.unit_items.can_be_bought` (boolean) Sofern true, kann der Nutzer einen Artikel kaufen. - `items.unit_items.drm_name` (string) DRM-Name. Example: "Steam" - `items.unit_items.drm_sku` (string) Eindeutige DRM-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten. Example: "steam" - `items.unit_items.has_keys` (boolean) Ist true eingestellt, lassen sich Spielschlüssel auf der Plattform kaufen. - `items.unit_items.is_pre_order` (boolean) Ist true eingestellt, ist der Spielschlüssel vorbestellbar und der Release-Termin noch nicht verstrichen. Example: true - `items.unit_items.release_date` (string,null) Release-Termin des Spielschlüssels im Format ISO 8601. Example: "2020-08-11T10:00:00+03:00" - `items.unit_items.promotions` (array) Auf bestimmte Artikel im Warenkorb angewandte Werbeaktionen. Das array wird in den folgenden Fällen zurückgegeben: * Für einen bestimmten Artikel ist eine Rabattaktion konfiguriert. * Ein Promocode mit der Einstellung Rabatt auf ausgewählte Artikel ist angewandt. Werden keine Werbeaktionen auf Artikelebene angewandt, wird ein leeres Array zurückgegeben. - `items.unit_items.promotions.name` (string) - `items.unit_items.promotions.date_start` (string,null) - `items.unit_items.promotions.date_end` (string,null) - `items.unit_items.promotions.discount` (object,null) - `items.unit_items.promotions.discount.percent` (string,null) - `items.unit_items.promotions.discount.value` (string,null) - `items.unit_items.promotions.bonus` (array) - `items.unit_items.promotions.bonus.sku` (string) - `items.unit_items.promotions.bonus.quantity` (integer) - `items.unit_items.promotions.bonus.type` (string) Typ des Bonusartikels. Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft" - `items.unit_items.promotions.bonus.name` (string) Name des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good. - `items.unit_items.promotions.bonus.image_url` (string) Bild-URL des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good. - `items.unit_items.promotions.bonus.bundle_type` (string) Typ des im Bundle enthaltenen Bonusartikels. Nur verfügbar für Bonusartikel vom Typ bundle. Enum: "standard", "virtual_currency_package" - `items.unit_items.promotions.limits` (object) - `items.unit_items.promotions.limits.per_user` (object) - `items.unit_items.promotions.limits.per_user.available` (integer) - `items.unit_items.promotions.limits.per_user.total` (integer) - `items.unit_items.periods` (array,null) Artikelangebotszeitraum. - `items.unit_items.periods.date_from` (string) Datum, an dem der angegebene Artikel zum Verkauf angeboten wird. Example: "2020-08-11T10:00:00+03:00" - `items.unit_items.periods.date_until` (string,null) Datum, an dem der angegebene Artikel nicht mehr zum Verkauf angeboten wird. Möglich ist: null. Example: "2020-08-11T20:00:00+03:00" - `items.unit_items.vp_rewards` (array) Liste Wertpunktbelohnungen für den Artikel. - `items.unit_items.vp_rewards.item_id` (integer) Interne eindeutige Artikel-ID. - `items.unit_items.vp_rewards.sku` (string) Eindeutige ID des Wertpunkts. - `items.unit_items.vp_rewards.amount` (integer) Anzahl der Wertpunkte. - `items.unit_items.vp_rewards.name` (string) Wertpunktname. - `items.unit_items.vp_rewards.image_url` (string) Bild-URL. - `items.unit_items.vp_rewards.is_clan` (boolean) Ob der Wertpunkt in Clan-Belohnungsketten verwendet wird. - `items.unit_items.loyalty_rewards` (array) Treuepunkte, die der Nutzer als Belohnung für den Kauf des Artikels erhält. - `items.unit_items.loyalty_rewards.name` (string) Treuepunktname. - `items.unit_items.loyalty_rewards.sku` (string) Treuepunkte-SKU. Übermittelnn Sie diesen Wert im Parameter loyalty_point_sku anderer API-Aufrufe, beispielsweise beim Anlegen einer mit Treuepunkten bezahlten Bestellung. - `items.unit_items.loyalty_rewards.description` (string) Treuepunktbeschreibung. - `items.unit_items.loyalty_rewards.image_url` (string,null) Bild-URL. - `items.unit_items.loyalty_rewards.amount` (integer) Wie viele Treuepunkte der Nutzer für den Kauf des Artikels erhält. - `items.unit_items.loyalty_prices` (array) Treuepunkte, mit denen der Artikel erworben werden kann. - `items.unit_items.loyalty_prices.name` (string) Treuepunktname. - `items.unit_items.loyalty_prices.sku` (string) Treuepunkte-SKU. Übermittelnn Sie diesen Wert im Parameter loyalty_point_sku anderer API-Aufrufe, beispielsweise beim Anlegen einer mit Treuepunkten bezahlten Bestellung. - `items.unit_items.loyalty_prices.description` (string) Treuepunktbeschreibung. - `items.unit_items.loyalty_prices.image_url` (string,null) Bild-URL. - `items.unit_items.loyalty_prices.amount` (integer) Artikelpreis in den angegebenen Treuepunkten.