为商品创建折扣促销活动

Digital Distribution Hub API

In-Game Store & Buy Button API

概览

下载API定义

用户属性

管理

个性化目录

捆绑包

管理

购物车和付款

购物车（客户端侧）

购物车（服务器侧）

支付（客户端）

支付（服务器端）

订单

免费商品

通用

Webhook

预订

商户

通用区域

游戏密钥

权利

管理

玩家物品库

客户端

管理

跨平台物品库

促销活动

通用

虚拟物品和货币

管理

虚拟支付

NFT商品

管理

限制

管理

REWARD CHAINS & VALUE POINTS

管理

客户端

Pay Station API

Publisher Account API

Subscriptions API

Webhooks

为商品创建折扣促销活动

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

为商品创建折扣促销活动。

促销活动提供商品折扣(%)。折扣将应用于指定商品的所有价格。

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

项目编号。您可以在您的发布商帐户项目名称旁边。

Example: 44056

Request Body schema: application/json

包含促销活动数据的对象。

required

Array of objects

Array

sku

required

string

Default: "elven_sword"

商品SKU。

required

object or null

percent

required

string

Default: "10.00"

百分比折扣。商品价格将按照此百分比打折，然后四舍五入到小数点后两位。

required

object

促销活动名称。应包含键/值对，其中键是格式为"^[a-z]{2}-[A-Z]{2}$"的区域设置，值是字符串。

property name*

additional property

string

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

One of:

与用户属性值进行比较的条件。必须满足所有条件操作才生效。

[ 1 .. 100 ] items

Array ([ 1 .. 100 ] items)

attribute

required

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

用户属性代码。

operator

required

string

按条件执行的操作类型。用于string属性类型。

Enum:	Description
eq	等于
ne	不等于

value

required

string <= 255 characters

与用户属性值进行比较的条件值。类型取决于属性类型。

type

required

string

用户属性类型。

Value: "string"

date_end

string or null <date-time>

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

促销活动结束日期。可以是null。

date_start

string or null <date-time>

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

促销活动开始日期。

object

促销活动限制。

per_user

integer or null

针对单独用户的促销活动限制。

object or null

限制次数刷新周期。

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

One of:

每天类型的用户限制次数刷新。

interval_type required	string 循环刷新周期。 Value: "daily"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... 所需时区的限制次数刷新时间（四舍五入到小时）。

Responses

201

促销活动已成功创建。

401

基本认证未通过或错误。确保您使用了基本认证或正确的凭据。

422

无效的请求。

Request samples

application/json

{"attribute_conditions": [{"attribute": "race",
"operator": "eq",
"value": "ork"
},
{"attribute": "level",
"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": [{"sku": "ork_helmet"
},
{"sku": "ork_gloves"
},
{"sku": "ork_chest"
},
{"sku": "ork_legs"
},
{"sku": "ork_boots"
}
],
"name": {"en-US": "Ork set discount",
"ru-RU": "Скидка на набор для орка"
}
}

Response samples

application/json

{"promotion_id": 2384756
}