# Spieleliste anhand angegebener Gruppe abrufen

Ruft eine Spieleliste aus der angegebenen Gruppe zum Erstellen eines Katalogs ab.

AchtungBei 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 Seite für Seite mehr Daten zu erhalten, verwenden Sie die Felder limit und offset.  HinweisDie API-Aufrufe für den Artikelkatalog können auch ohne Autorisierung verwendet werden. Um jedoch einen personalisierten Katalog abzurufen, müssen Sie den Benutzer-JWT im Authorization-Header übermitteln.

Endpoint: GET /v2/project/{project_id}/items/game/group/{external_id}
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
    Example: 44056

  - `external_id` (string, required)
    Externe ID der Gruppe.

## 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. Sprachcode bestehend aus zwei Kleinbuchstaben gemäß ISO 639-1.

  - `additional_fields[]` (array)
    Die Liste der zusätzlichen Felder. Diese Felder sind in der Antwort enthalten, sofern Sie diese in der Anfrage senden.
    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.
    Example: true

  - `items` (array)
    Example: [{"attributes":[{"external_id":"genre","name":"Genre","values":[{"external_id":"23fda05111c125608af8f1fa0e99db45a10ea1cc","value":"Horror"}]}],"description":"Game description","groups":[{"external_id":"all","name":"All games"},{"external_id":"Xsolla","name":"Xsolla games"}],"image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","name":"Game name","promotions":[],"sku":"com.xsolla.game_1","type":"unit","unit_items":[{"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_1","has_keys":true,"is_free":false,"is_pre_order":true,"periods":[{"date_from":"2020-08-11T10:00:00+03:00","date_until":"2020-08-11T20:00:00+03:00"}],"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"promotions":[],"release_date":"2020-08-11T10:00:00+03:00","sku":"com.xsolla.game_key_01","type":"game_key","virtual_prices":[]},{"can_be_bought":true,"drm_name":"Origin","drm_sku":"origin_key_1","has_keys":false,"is_free":false,"is_pre_order":false,"periods":[],"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"promotions":[],"release_date":null,"sku":"com.xsolla.game_key_02","type":"game_key","virtual_prices":[]}],"unit_type":"game"},{"attributes":[{"external_id":"OS","name":"OS","values":[{"external_id":"9d5c5efb7c0f00a00fe4e3583f1215b0050bc723","value":"Windows"}]}],"description":"Game description","groups":[{"external_id":"all","name":"All games"}],"image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","name":"Game name","promotions":[],"sku":"com.xsolla.game_2","type":"unit","unit_items":[{"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_2","has_keys":false,"is_free":false,"is_pre_order":false,"periods":[{"date_from":null,"date_until":"2020-08-11T20:00:00+03:00"}],"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"promotions":[],"release_date":null,"sku":"com.xsolla.game_key_01","type":"game_key","virtual_prices":[]}],"unit_type":"game"}]

  - `items.attributes` (array)
    Liste der Attribute und ihrer Werte, die dem Artikel zugeordnet sind. Kann für die Katalogfilterung verwendet werden.
    Example: {"value":{"external_id":"genre","name":"Жанр","values":[{"external_id":"genre_e3364991f92e751689a68b96598a5a5a84010b85","value":"Casual"},{"external_id":"genre_eba07bfd0f982940773cba3744d97264dd58acd7","value":"Strategy"},{"external_id":"genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8","value":"Mobile"}]}}

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

  - `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.
    Example: "attribute_value"

  - `items.attributes.values.value` (string)
    Wert des Attributs.
    Example: "Strategy"

  - `items.description` (string)
    Artikelbeschreibung.
    Example: "Game description"

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

  - `items.groups.external_id` (string)
    Eindeutige Kennung für die Gruppe. Dient normalerweise dazu, in API-Anfragen oder externen Systemen auf die Gruppe zu verweisen.
    Example: "exclusive"

  - `items.groups.item_order_in_group` (integer)
    Die Position des Artikels innerhalb der Gruppe. Dient dazu, die Anzeigereihenfolge festzulegen.
Dieses Feld ist nur dann in der Antwort enthalten, wenn es über den Abfrageparameter additional_fields[] angefordert wird.
    Example: 1

  - `items.groups.name` (string)
    Name der Gruppe.
    Example: "Exclusive"

  - `items.image_url` (string)
    Bild-URL.
    Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png"

  - `items.name` (string)
    Artikelname.
    Example: "Game name"

  - `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.bonus` (array)

  - `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.bonus.image_url` (string)
    Bild-URL des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good.

  - `items.promotions.bonus.name` (string)
    Name des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good.

  - `items.promotions.bonus.quantity` (integer)

  - `items.promotions.bonus.sku` (string)

  - `items.promotions.bonus.type` (string)
    Typ des Bonusartikels.
    Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft"

  - `items.promotions.date_end` (string,null)

  - `items.promotions.date_start` (string,null)

  - `items.promotions.discount` (object,null)

  - `items.promotions.discount.percent` (string,null)

  - `items.promotions.discount.value` (string,null)

  - `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.promotions.name` (string)

  - `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.type` (string)
    Artikeltyp: virtual_good/virtual_currency/bundle/physical_good/unit.
    Example: "unit"

  - `items.unit_items` (array)

  - `items.unit_items.can_be_bought` (boolean)
    Sofern true, kann der Nutzer einen Artikel kaufen.
    Example: true

  - `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_free` (boolean)
    Ist true eingestellt, ist der Artikel kostenlos.

  - `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.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.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.release_date` (string,null)
    Release-Termin des Spielschlüssels im Format ISO 8601.
    Example: "2020-08-11T10:00:00+03:00"

  - `items.unit_items.type` (string)
    Artikeltyp: game_key.
    Example: "game_key"

  - `items.unit_items.virtual_prices` (array)
    Virtuelle Preise.

  - `items.unit_items.virtual_prices.amount` (integer)
    Rabattierter Artikelpreis in virtueller Währung.
    Example: 100

  - `items.unit_items.virtual_prices.description` (string)
    Beschreibung der virtuellen Währung.
    Example: "Big Rocket - description"

  - `items.unit_items.virtual_prices.image_url` (string)
    Bild der virtuellen Währung.
    Example: "http://image.png"

  - `items.unit_items.virtual_prices.is_default` (boolean)
    Ob der Preis für den Artikel voreingestellt ist.
    Example: true

  - `items.unit_items.virtual_prices.name` (string)
    Name der virtuellen Währung.
    Example: "SHOTGUN FOR TRUE RAIDERS"

  - `items.unit_items.virtual_prices.sku` (string)
    Artikel-SKU der virtuellen Währung.
    Example: "vc_test"

  - `items.unit_items.virtual_prices.type` (string)
    Art der virtuellen Währung.
    Example: "virtual_currency"

  - `items.unit_items.vp_rewards` (array)
    Wertpunktartikel-Belohnung.

  - `items.unit_items.vp_rewards.amount` (integer)
    Anzahl der Wertpunkte.

  - `items.unit_items.vp_rewards.is_clan` (boolean)
    Ob der Wertpunkt in Clan-Belohnungsketten verwendet wird.
    Example: true

  - `items.unit_items.vp_rewards.item_id` (integer)
    Interne eindeutige Artikel-ID.
    Example: 1

  - `items.unit_items.vp_rewards.name` (string)
    Wertpunktname.

  - `items.unit_items.vp_rewards.sku` (string)
    Eindeutige ID des Wertpunkts.

  - `items.unit_type` (string)
    Einheitstyp: game.
    Example: "game"