# 创建赠品活动
# 接口说明
可通过该接口添加买赠活动
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/product/activity/add?access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| activity_id | uint64 | 否 | 买赠活动id，如果不填，则自动生成 |
| title | string | 是 | 买赠活动标题 |
| start_time | number | 是 | 买赠活动开始时间(秒级时间戳)，只能取大于等于当前时间的值，且距离当前时间不得超过30天 |
| end_time | number | 是 | 买赠活动结束时间(秒级时间戳)，必须大于当前时间以及start_time，且活动持续时间(end_time-start_time)需大于等于10分钟，小于等于30天 |
| detail.show_scene | number | 是 | 买赠活动生效的场景值。0:全场景展示;1:仅直播间展示 |
| detail.receive_limit.is_limited | number | 是 | 是否限领 |
| detail.receive_limit.limit_num | number | 是 | 限领套数 |
| detail.main_products[].product_id | number | 是 | 买赠活动的主品id |
| detail.gift_set.gift_set_num | number | 是 | 买赠活动的赠品总套数 |
| detail.gift_set.gift_items[].gift_id | number | 是 | 单套赠品内的赠品id |
| detail.gift_set.gift_items[].give_num | number | 是 | 单套赠品内的赠品件数 |
# 请求参数示例
{
"gift_activity": {
"activity_id": 123456789147,
"detail": {
"gift_set": {
"gift_items": [
{
"gift_id": 121212,
"give_num": 1
}
],
"gift_set_num": 1
},
"main_products": [
{
"product_id": 121212
}
],
"receive_limit": {
"is_limited": true,
"limit_num": 111
},
"show_scene": 1
},
"end_time": "11111",
"start_time": "222222",
"title": "测试创建赠品活动"
}
}
# 返回参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| activity_id | uint64 | 买赠活动ID，创建成功后返回 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"activity_id": "123456789147"
}
# 错误码
| 错误码 | 错误描述 |
|---|---|
| 公共错误码 | - |
| 268560001 | 活动名称为空 |
| 268560002 | 活动主品列表为空 |
| 268560003 | 活动赠品列表为空 |
| 268560004 | 活动赠品商品不存在 |
| 268560005 | 活动赠品商品不是上架状态 |
| 268560006 | 活动赠品库存不足 |
| 268560007 | 活动赠品总价值太高 |
| 268560008 | 活动赠品价值比主品价值高 |
| 268560009 | 未来的活动太多 |
| 268560010 | 商品在未来的活动中已存在 |
| 268560011 | 主品或者赠品不满足类目规则的要求 |
| 268560012 | 不支持个人店铺类型 |
| 268560013 | 赠品活动参数数量异常 |