# Liste der Artikelaktionen abrufen

Ruft die Liste der Artikelaktionen eines Projekts ab.

Werbeaktionen gewähren einen Rabatt (in %) auf Artikel.
Der Rabatt wird auf alle Preise der angegebenen Artikel angewendet.

Endpoint: GET /v3/project/{project_id}/admin/promotion/item
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID.

## Query parameters:

  - `limit` (integer)
    Begrenzung der Elementanzahl auf der Seite.

  - `offset` (integer)
    Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0).

## Response 200 fields (application/json):

  - `promotions` (array)

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

  - `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.is_enabled` (boolean)
    Ob die Werbeaktion aktiviert ist oder nicht.

  - `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: {"en-US":"Promotion","ru-RU":"Акция"}

  - `promotions.discount` (object)

  - `promotions.discount.percent` (string,null)
    Prozentualer Rabatt.
Der Preis des Artikels wird um einen Wert verringert, der anhand dieses Prozentsatzes berechnet wird.

  - `promotions.items` (array,null)

  - `promotions.items.sku` (string,null)
    Artikel-SKU.

  - `promotions.attribute_conditions` (array)
    Bedingungen für die Validierung von Nutzerattributen.
Steuert die Verfügbarkeit der Werbeaktion basierend darauf, ob die Nutzerattribute alle angegebenen Bedingungen erfüllen.

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

  - `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.per_item` (integer,null)
    Globale Artikelbeschränkung.
    Example: 10

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

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

  - `promotions.excluded_promotions` (array)
    Liste der IDs der Werbeaktionen, die bei der Anwendung dieser Werbeaktion ausgeschlossen werden sollen. Example: [12, 789]

  - `promotions.price_conditions` (array,null)
    Objekt-Array mit Bedingungen für die Preisspanne, innerhalb der die Werbeaktion angewandt wird. Die Aktion wird nur auf Artikel angewandt, deren Preis alle in dem Array aufgelisteten Bedingungen erfüllt. Wenn Sie dieses Array übermitteln, müssen Sie den Wert des Objekts [items](/de/api/shop-builder/operation/create-item-promotion/#!path=items&t=request) auf null setzen.

  - `promotions.price_conditions.operator` (string, required)
    Vergleichsoperator zum Festlegen der Preisspanne für die Anwendung der Werbeaktion.

Mögliche Werte:
- ge – ist größer oder gleich
- gt – ist größer als
- le – ist kleiner oder gleich
- lt – ist kleiner als
- eq – ist gleich
- ne – ist nicht gleich
    Enum: "ge", "gt", "le", "lt", "eq", "ne"

  - `promotions.price_conditions.value` (string, required)
    Wert zur Bestimmung der Preisspanne für die Anwendung der Werbeaktion.

  - `total_promotions_count` (integer)
    Gesamtzahl der Werbeaktionen.

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

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

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

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