Mettre à jour une promotion sur les objets

Note

Les nouvelles données remplaceront les anciennes. Si vous souhaitez mettre à jour une promotion partiellement, assurez-vous de passer toutes les données requises dans la requête.

Les promotions offrent une remise (%) sur les objets. La remise s'applique à tous les prix des objets spécifiés.

SecuritybasicAuth

Request

path Parameters

project_id required	integer ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet. Example: 44056
promotion_id required	integer ID de la promotion. Identifiant unique de la promotion au sein du projet. Example: 111425

Request Body schema: application/json

Objet contenant des données de la promotion.

required

Array of objects

Array

sku

required

string

Default: "elven_sword"

UGS de l'objet.

required

object

percent

required

string

Pourcentage de la remise. Le prix de l'objet sera réduit d'une valeur calculée à l'aide de ce pourcentage et arrondie à 2 décimales.

required

object

Nom de la promotion. Doit comprendre des paires clé/valeur, où la clé est une région au format "^[a-z]{2}-[A-Z]{2}$", la valeur est une chaîne.

property name*

additional property

string

Array of type = string (objects) or Array of type = date (objects) or Array of type = number (objects)

One of:

Conditions comparées aux valeurs des attributs utilisateur. Toutes les conditions doivent être remplies pour que l'action ait un effet.

[ 1 .. 100 ] items

Array ([ 1 .. 100 ] items)

attribute

required

string [ 1 .. 255 ] characters ^[-_.\\d\\w]+$

Code d'attribut utilisateur.

operator

required

string

Type d'opération effectuée par la condition. Pour le type d'attribut string.

Enum:	Description
eq	Égal
ne	Différent de

value

required

string <= 255 characters

Valeur de la condition à laquelle la valeur de l'attribut utilisateur sera comparée. Le type dépend du type d'attribut.

type

required

string

Type d'attribut utilisateur.

Value: "string"

can_be_missing

boolean

Indique que la condition est remplie même si l'attribut est absent des attributs de l'utilisateur. Passez true pour afficher l'objet pour les utilisateurs ne possédant pas cet attribut. Les utilisateurs ayant l'attribut, mais dont la valeur ne correspond pas à celle définie dans la condition ne verront pas l'objet. Si vous passez false, les utilisateurs dont l'attribut est manquant ou dont la valeur ne correspond pas à celle spécifiée dans la condition ne verront pas l'objet.

date_end

string or null <date-time>

Default: "2020-04-15T18:16:00+05:00"

Date de fin de la promotion. Peut prendre la valeur null.

date_start

string or null <date-time>

Default: "2020-04-15T18:16:00+05:00"

Date de début de la promotion.

object

Limites de la promotion.

per_user

integer or null

Limites de la promotion pour un utilisateur spécifique.

object or null

Délai d'actualisation des limites.

interval_type = daily (object) or interval_type = weekly (object) or interval_type = monthly (object)

One of:

Type quotidien d'actualisation des limites pour l'utilisateur.

interval_type required	string Délai d'actualisation récurrent. Value: "daily"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... Heure d'actualisation des limites dans le fuseau horaire souhaité (arrondie en heures).

object or null

Condition d'application de la promotion aux biens dont le prix se situe dans une fourchette spécifiée. Dans l'objet price_range_condition, fournissez une valeur pour au moins un des paramètres suivants : lower_limit ou upper_limit.
Si des biens sont spécifiés dans l'objet items, la promotion ne s'applique qu'à ces biens et dans la fourchette de prix indiquée.
Pour que la condition promotionnelle s'applique à tous les biens, définissez la valeur null dans l'objet items.

lower_limit required	string or null Limite inférieure de la fourchette de prix pour l'application de la promotion. Si la valeur `lower_limit` est définie, la promotion ne s'applique qu'aux biens dont le prix est supérieur ou égal à cette valeur. La valeur du prix est exprimée dans la devise par défaut. Exemple : `"10.0000"`
upper_limit required	string or null Limite supérieure de la fourchette de prix pour l'application de la promotion. Si la valeur `upper_limit` est définie, la promotion ne s'applique qu'aux biens dont le prix est inférieur ou égal à cette valeur. La valeur du prix est exprimée dans la devise par défaut. Exemple : `"20.0000"`

Responses

204

La promotion a été mise à jour avec succès.

401

L'authentification de base n'a pas été passée ou est incorrecte. Vérifiez que vous avez utilisé l'authentification de base ou des informations d'identification correctes.

404

Promotion non trouvée. Assurez-vous que le paramètre promotion_id est correct.

422

Requête non valide.

Request samples

application/json

{"attribute_conditions": [{"attribute": "race",
"operator": "eq",
"value": "ork"
},
{"attribute": "level",
"can_be_missing": true,
"operator": "ge",
"value": "10"
}
],
"date_end": "2020-04-25T18:16:00+05:00",
"date_start": "2020-04-15T18:16:00+05:00",
"discount": {"percent": "24.00"
},
"items": null,
"name": {"en-US": "Ork set discount",
"ru-RU": "Скидка на набор для орка"
}
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}