Xsolla-logo

Artikelaktion aktualisieren

put/v2/project/{project_id}/admin/promotion/{promotion_id}/item

Aktualisiert die Werbeaktion.

Hinweis

Neue Daten ersetzen alte Daten. Auch wenn Sie nur einen Teil einer Werbeaktion aktualisieren möchten, sollten Sie alle erforderlichen Daten in der Anfrage übermitteln.

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
promotion_id
required
integer

Werbeaktions-ID. Eindeutige Werbeaktionskennung innerhalb des Projekts.

Example: 111425
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
204

Die Werbeaktion wurde erfolgreich aktualisiert.

401

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

404

Werbeaktion nicht gefunden. Prüfen Sie, ob die promotion_id korrekt ist.

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
{
  • "errorCode": 1020,
  • "errorMessage": "[0401-1020]: Error in Authentication method occurred",
  • "statusCode": 401
}