# Liste aller Werbeaktionen abrufen

Ruft die Liste der Werbeaktionen eines Projekts ab.

Endpoint: GET /v3/project/{project_id}/admin/promotion
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).

  - `enabled` (integer)
    Elemente nach is_enabled-Flag filtern.

## Response 200 fields (application/json):

  - `active_promotions_count` (integer)
    Anzahl der aktiven Werbeaktionen.

  - `inactive_promotions_count` (integer)
    Anzahl der deaktivierten Werbeaktionen.

  - `promotions` (array)

  - `promotions.bonus` (array)

  - `promotions.bonus.item` (object)

  - `promotions.bonus.item.bundle_type` (string)
    Bündeltyp. Wird zurückgegeben, wenn der Artikeltyp ein Bündel ist.
    Enum: "standard", "virtual_currency_package"

  - `promotions.bonus.item.content` (array)

  - `promotions.bonus.item.description` (string,null)
    Artikelbeschreibung.
    Example: "Game description"

  - `promotions.bonus.item.image_url` (string,null)
    Bild-URL.
    Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png"

  - `promotions.bonus.item.name` (object)
    Artikelname.
    Example: {"en":"Game name"}

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

  - `promotions.bonus.item.type` (string)
    Artikeltyp: virtual_good/virtual_currency/bundle/physical_good/unit.
    Example: "unit"

  - `promotions.bonus.item.unit_items` (array)
    Artikel vom Typ "Unit" enthalten alle Artikel in der Einheit. In den meisten Fällen sollte der Nutzer einen davon als Gutscheinbonus auswählen.

  - `promotions.bonus.item.unit_items.drm_name` (string)
    DRM-Name.
    Example: "Steam"

  - `promotions.bonus.item.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"

  - `promotions.bonus.item.unit_items.is_free` (boolean)

  - `promotions.bonus.item.unit_items.type` (string)
    Artikeltyp: game_key.
    Example: "game_key"

  - `promotions.bonus.quantity` (number)
    Artikelmenge.

  - `promotions.condition` (array,null)

  - `promotions.discount` (object,null)
    Example: {"discount":{"percent":"10.99"}}

  - `promotions.discount.percent` (string,null)
    Prozentualer Rabatt.
Der Preis des Warenkorbs wird um einen Wert verringert, der anhand dieses Prozentsatzes berechnet und dann auf zwei Dezimalstellen gerundet wird.
    Example: "10.00"

  - `promotions.id` (integer)
    Werbeaktions-ID. Eindeutige Werbeaktionskennung innerhalb des Projekts.
    Example: 1

  - `promotions.is_enabled` (boolean)

  - `promotions.limits` (object)
    Werbebeschränkungen.

  - `promotions.limits.per_item` (integer,null)
    Globale Artikelbeschränkung.
    Example: 10

  - `promotions.limits.per_user` (object,null)
    Werbebeschränkungen für einen separaten Nutzer.

  - `promotions.limits.per_user.total` (integer)
    Gesamtzahl der pro Nutzer erhältlichen Artikel. Sie können diese Nummer im Kundenportal festlegen oder Admin-Endpunkte für Store-Entitäten (Beschränkungsobjekt) verwenden.
    Example: 5

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

  - `promotions.limits.recurrent_schedule.per_user` (object)
    Aktualisierungszeitraum für das Nutzerlimit.

  - `promotions.limits.recurrent_schedule.per_user.day_of_month` (integer,null)
    Tag im Monat, an dem die Limits aktualisiert werden. Hat der Monat weniger Tage als der ausgewählte Tag, erfolgt die Aktualisierung am letzten Tag des Monats. null ist bei Limitaktualisierungszeiträumen vom Typ monthly unzulässig.

  - `promotions.limits.recurrent_schedule.per_user.day_of_week` (integer,null)
    Wochentag, an dem die Limits aktualisiert werden. 1 seht für Montag, und 7 steht für Sonntag. null ist bei Limitaktualisierungszeiträumen vom Typ weekly unzulässig.

  - `promotions.limits.recurrent_schedule.per_user.displayable_reset_next_date` (string)
    Datum und Uhrzeit, zu der die Limits zurückgesetzt werden sollen (ISO 8601).
    Example: "2023-02-28T11:00:00+08:00"

  - `promotions.limits.recurrent_schedule.per_user.displayable_reset_start_date` (string)
    Datum und Uhrzeit der ersten Limitaktualisierung (ISO 8601).
    Example: "2023-02-28T11:00:00+08:00"

  - `promotions.limits.recurrent_schedule.per_user.interval_type` (string)
    Typ des wiederkehrenden Aktualisierungszeitraums.
    Enum: "daily", "weekly", "monthly"

  - `promotions.limits.recurrent_schedule.per_user.reset_next_date` (integer)
    Datum und Uhrzeit der Limitaktualisierung (Unix-Zeitstempel).
    Example: 1677553200

  - `promotions.limits.recurrent_schedule.per_user.time` (string)
    Zeitpunkt der Limitaktualisierung in der gewünschten Zeitzone (auf Stunden gerundet).
    Example: "11:00:00+03:00"

  - `promotions.name` (object)
    Name der Werbeaktion. Sollte Schlüssel-Wert-Paare enthalten,
wobei der Schlüssel ein Gebietsschema im Format "^[a–z]{2}-[A–Z]{2}$" und der Wert ein String ist.
    Example: {"de-DE":"Gutscheintitel","en-US":"Coupon title"}

  - `promotions.promotion_periods` (array)
    Gültigkeitszeitraum der Werbeaktion. Wenn mehrere Zeiträume angegeben sind, sind sowohl date_from als auch date_until erforderlich.

  - `promotions.promotion_periods.date_from` (string, required)
    Startdatum für die angegebene Werbeaktion.
    Example: "2020-08-11T10:00:00+03:00"

  - `promotions.promotion_periods.date_until` (string,null)
    Enddatum für die angegebene Werbeaktion. Wenn null festgelegt ist, läuft die Werbeaktion unbefristet. Kann nur null sein, wenn ein einzelner Gültigkeitszeitraum angegeben ist.
    Example: "2020-08-11T20:00:00+03:00"

  - `promotions.type` (string)
    Werbeaktionstyp.
    Example: "item_discount"

  - `total_promotions_count` (integer)
    Gesamtzahl der Werbeaktionen.

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

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

  - `statusCode` (integer)
    Example: 401