# Spieleliste abrufen (Verwaltung)

Ruft eine Liste der Spiele innerhalb eines Projekts zur Verwaltung ab.
Das Spiel besteht aus Spielschlüsseln, die von einem Nutzer gekauft werden können.

HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.

Endpoint: GET /v2/project/{project_id}/admin/items/game
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
    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).

  - `promo_code` (string)
    Eindeutiger Code, es wird zwischen Groß- und Kleinschreibung unterschieden. Enthält Buchstaben und Ziffern.
    Example: "WINTER2021"

## Response 200 fields (application/json):

  - `items` (array)

  - `items.attributes` (array)
    Liste der Attribute.
    Example: [{"external_id":"attribute_external_id","name":{"de":"Attributname","en":"Attribute name"},"values":[{"external_id":"value_1","name":{"de":"wert 1","en":"value 1"}},{"external_id":"value_2","name":{"de":"wert 2","en":"value 2"}}]}]

  - `items.attributes.external_id` (string, required)
    Eindeutige Attribut-ID. Die external_id darf nur lateinische Klein- und Großbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten.
    Example: "attribute_1"

  - `items.attributes.name` (object)
    Objekt mit lokalisierten Attributnamen. Schlüssel sind in ISO 3166-1 spezifiziert.
    Example: {"de":"Genre","en":"Genre"}

  - `items.attributes.values` (array, required)
    Example: [{"external_id":"value_1","name":{"de":"wert 1","en":"value 1"}},{"external_id":"value_2","name":{"de":"wert 2","en":"value 2"}}]

  - `items.attributes.values.external_id` (string, required)
    Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.
    Example: "attribute_value"

  - `items.attributes.values.value` (object, required)
    Objekt mit lokalisierten Wertnamen. Schlüssel sind in ISO 3166-1 spezifiziert.
    Example: {"de":"Strategie","en":"Strategy"}

  - `items.description` (object,null)
    Objekt mit Lokalisierungen für Artikelbeschreibungen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Optionen angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/).

  - `items.groups` (array)
    Gruppen, zu denen der Artikel gehört.
    Example: [{"external_id":"horror","name":{"en":"Horror"}}]

  - `items.groups.external_id` (string)
    Example: "horror"

  - `items.groups.name` (object)
    Example: {"en":"Horror"}

  - `items.image_url` (string)
    Bild-URL.
    Example: "https://image.example.com"

  - `items.is_enabled` (boolean)
    Ist diese Option deaktiviert, kann der Artikel weder gekauft noch über das Inventar aufgerufen werden.

  - `items.is_free` (boolean)
    Ist true eingestellt, ist der Artikel kostenlos.

  - `items.is_show_in_store` (boolean)
    Artikel ist käuflich erhältlich.

  - `items.item_id` (integer)
    Interne eindeutige Artikel-ID, die bei der Artikelerstellung vergeben wird.
    Example: 1

  - `items.long_description` (object,null)
    Objekt mit Lokalisierungen für lange Artikelbeschreibungen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Varianten angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/).

  - `items.media_list` (array)
    Zusätzliche Spiel-Medieninhalte wie Screenshots, Gameplay-Videos usw.
    Example: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}]

  - `items.media_list.type` (string)
    Medieninhaltstyp: image/video.
    Enum: "image", "video"

  - `items.media_list.url` (string)
    Ressourcendatei.
    Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"

  - `items.name` (object,null)
    Objekt mit Lokalisierungen für Artikelnamen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Optionen angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/).

  - `items.order` (integer)
    Priorität der Spielreihenfolge in der Liste.
    Example: 1

  - `items.sku` (string)
    Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.
    Example: "game_1"

  - `items.type` (string)
    Artikeltyp. In diesem Fall immer unit.
    Example: "unit"

  - `items.unit_items` (array)
    Spielschlüssel für verschiedene DRMs.

  - `items.unit_items.drm_id` (integer)
    Interne eindeutige DRM-ID.
    Example: 1

  - `items.unit_items.drm_image` (string,null)
    DRM-Symbol für den Spielschlüssel.
    Example: "https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png"

  - `items.unit_items.drm_name` (string)
    DRM-Name des Spielschlüssels.
    Example: "Steam"

  - `items.unit_items.drm_sku` (string)
    Eindeutige DRM-ID.
    Example: "steam"

  - `items.unit_items.is_sales_exist` (boolean)
    Ist true eingestellt, wurde der Spielschlüssel von Nutzern gekauft.

  - `items.unit_items.keys` (object)

  - `items.unit_items.keys.available` (integer)
    Anzahl der käuflich erhältlichen Schlüssel.

  - `items.unit_items.keys.total` (integer)
    Gesamtzahl der hochgeladenen Schlüssel.

  - `items.unit_items.keys.used` (integer)
    Anzahl der verkauften Schlüssel.

  - `items.unit_items.limits` (object,null)
    Artikelbeschränkungen.

  - `items.unit_items.limits.per_item` (object,null)
    Globale Artikelbeschränkung.

  - `items.unit_items.limits.per_item.available` (integer)
    Verbleibende Anzahl von Artikeln, die alle Nutzer kaufen können.

  - `items.unit_items.limits.per_item.reserved` (integer)

  - `items.unit_items.limits.per_item.sold` (integer)

  - `items.unit_items.limits.per_item.total` (integer)
    Höchstzahl von Artikeln, die alle Nutzer kaufen können.

  - `items.unit_items.limits.per_user` (object,null)
    Artikelbeschränkung für einen separaten Nutzer.

  - `items.unit_items.limits.per_user.limit_exceeded_visibility` (string)
    Steuert die Sichtbarkeit des Artikels im Katalog nach Erreichen des Kauflimits, und zwar bis das Limit das nächste Mal zurückgesetzt wird.

Gilt für Artikel, bei denen im Array recurrent_schedule Limits konfiguriert sind, die regelmäßig zurückgesetzt werden.

Ist keine Zurücksetzung konfiguriert, wird der Artikel nach Erreichen des Kauflimits nicht im Katalog angezeigt, unabhängig vom Wert des Parameters limit_exceeded_visibility.
    Enum: "show", "hide"

  - `items.unit_items.limits.per_user.total` (integer)
    Höchstzahl von Artikeln, die ein einzelner Nutzer kaufen kann.

  - `items.unit_items.limits.recurrent_schedule` (object,null)
    Aktualisierungszeitraum begrenzen.

  - `items.unit_items.limits.recurrent_schedule.per_user` (object,null)
    Aktualisierungszeitraum für das Nutzerlimit.

  - `items.unit_items.periods` (array)
    Artikelangebotszeitraum.

  - `items.unit_items.periods.date_from` (string,null)
    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.pre_order` (object)
    Vorbestelleinstellungen.

  - `items.unit_items.pre_order.description` (string,null)
    Zusätzliche Vorbestellinformationen, die per E-Mail verschickt werden.

  - `items.unit_items.pre_order.is_enabled` (boolean)
    Wenn diese Option deaktiviert ist, kann der Artikel nicht vorbestellt werden.

  - `items.unit_items.pre_order.release_date` (string,null)
    Release-Termin des Spielschlüssels im Format ISO 8601.

  - `items.unit_items.prices` (array)
    Preise in echten Währungen.
    Example: [{"amount":1299.99,"currency":"RUB","is_default":true,"is_enabled":true}]

  - `items.unit_items.prices.amount` (number)
    Example: 1299.99

  - `items.unit_items.prices.country_iso` (string,null)
    Land, in dem dieser Preis gilt. Code bestehend aus zwei Buchstaben gemäß [ISO 3166-1 Alpha 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Example: "US"

  - `items.unit_items.prices.currency` (string)
    Währung des Artikelpreises. Dreistelliger Code pro [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "RUB"

  - `items.unit_items.prices.is_default` (boolean)
    Der Standardpreis dient dazu, den Katalog zu erstellen, wenn kein Preis in der Währung des Nutzers angegeben ist.

  - `items.unit_items.prices.is_enabled` (boolean)

  - `items.unit_items.regions` (array)

  - `items.unit_items.regions.id` (integer)
    Example: 1

  - `items.unit_items.type` (string)
    Artikeltyp. In diesem Fall immer game_key.
    Example: "game_key"

  - `items.unit_items.virtual_prices` (array,null)
    Example: [{"amount":1000,"description":null,"image_url":"https://i.pinimg.com/originals/91/ae/56/91ae5683045f6dbef16b1482bade938f.png","is_default":true,"name":{"en":"Gold"},"sku":"com.xsolla.gold_1","type":"virtual_currency"}]

  - `items.unit_items.virtual_prices.description` (object,null)
    Objekt mit lokalisierten Spielbeschreibung. Die Schlüssel sind in ISO 3166-1 spezifiziert.
    Example: {"en":"Game 1 Example"}

  - `items.unit_items.virtual_prices.is_default` (boolean)

  - `items.unit_items.virtual_prices.name` (object)
    Objekt mit lokalisierten Namen der virtuellen Währung. Schlüssel sind in ISO 3166-1 spezifiziert.
    Example: {"en":"Gold"}

  - `items.unit_items.virtual_prices.type` (string)
    Artikeltyp. In diesem Fall immer virtual_currency.
    Example: "virtual_currency"

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401