Xsolla-logo

Rabattaktion für Artikel erstellen

post/v2/project/{project_id}/admin/promotion/item

Erstellt eine Rabattaktion für einen Artikel.

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

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

Projekt-ID.

Example: 44056
Request Body schema: application/json

Objekt mit Werbeaktionsdaten.

required
Array of objects
Array
sku
required
string
Default: "elven_sword"

Artikel-SKU.

required
object or null
percent
required
string
Default: "10.00"

Prozentualer Rabatt. Der Preis des Artikels wird um einen Wert verringert, der anhand dieses Prozentsatzes berechnet und dann auf zwei Dezimalstellen gerundet wird.

required
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.

property name*
additional property
string
Array of objects [ 1 .. 100 ] items

Bedingungen, die mit Benutzerattributwerten verglichen werden. Alle Bedingungen müssen erfüllt sein, damit die Aktion greift.

Array ([ 1 .. 100 ] items)
attribute
required
string [ 1 .. 255 ] characters ^[-_.\\d\\w]+$

Benutzerattributcode.

operator
required
string

Typ der durch Bedingung ausgeführten Operation.

Enum: Description
eq

Gleich

ge

Größer oder gleich

gt

Größer

le

Kleiner oder gleich

lt

Kleiner

ne

Ungleich

value
required
string <= 255 characters

Bedingungswert, mit dem der Benutzerattributwert verglichen wird. Der Typ hängt vom Attributtyp ab.

type
required
string

Benutzerattributtyp.

Enum: "string" "date" "number"
date_end
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Datum, an dem Ihre Werbeaktion endet. Möglich ist null.

date_start
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Datum, an dem Ihre Werbeaktion beginnt.

object

Werbebeschränkungen.

per_user
integer or null

Werbebeschränkungen für einen separaten Benutzer.

object or null

Aktualisierungszeitraum begrenzen.

object or object or object
One of:

Tägliche Aktualisierung der Benutzerlimits.

interval_type
required
string

Wiederkehrender Aktualisierungszeitraum.

Value: "daily"
time
required
string((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1...

Zeitpunkt der Limitaktualisierung in der gewünschten Zeitzone (auf Stunden gerundet).

Responses
201

Werbeaktion wurde erfolgreich erstellt.

401

Basisauthentifizierung nicht bestanden oder falsch. Prüfen Sie die Anmeldedaten und vergewissern Sie sich, dass Sie die Basisauthentifizierung verwenden.

422

Ungültige Anfrage.

Request samples
application/json
{
  • "attribute_conditions": [
    ],
  • "date_end": "2020-04-25T18:16:00+05:00",
  • "date_start": "2020-04-15T18:16:00+05:00",
  • "discount": {
    },
  • "items": [
    ],
  • "name": {
    }
}
Response samples
application/json
{
  • "promotion_id": 2384756
}