文档中心 > API类目 > 五道口营销域

alibaba.wdk.marketing.itempool.activity.create (创建活动新接口)

创建活动新接口,支持新工具玩法

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param ItemPoolActivity 必须 创建活动请求入参
  • limit_info
  • LimitInfo
  • 可选
  • 通用限购信息,-1为不限制,默认为不限制
  • └ user_daily_limit_cnt
  • Number
  • 可选
  • 20
  • 每人每日限购
  • └ user_limit_cnt
  • Number
  • 可选
  • 20
  • 每人活动期间总限购
  • └ total_limit_cnt
  • Number
  • 可选
  • 20
  • 活动期间总限购
  • └ daily_limit_cnt
  • Number
  • 可选
  • 10
  • 活动每日总限购
  • rule_stairs
  • OpenPromotionRuleStair []
  • 必须
  • 商品池活动的梯度列表
  • cap_count_discount_rule
  • CapCountDiscountRule
  • 可选
  • 指定件数优惠规则
  • └ cap_count_each_fix_price
  • Number
  • 可选
  • 20
  • 指定件数每件一口价【分】
  • └ cap_count_discount_rate
  • Number
  • 可选
  • 30
  • 指定件数整体打几折【600=6折】
  • └ cap_count_decrease_money
  • Number
  • 可选
  • 40
  • 指定件数整体减钱【分】
  • └ cap_count_fix_price
  • Number
  • 可选
  • 50
  • 指定件数整体一口价【分】
  • └ is_cap_count_fix_price
  • Boolean
  • 可选
  • false
  • 是否指定件数整体一口价
  • └ is_cap_count_decrease_money
  • Boolean
  • 可选
  • false
  • 是否指定件数整体减钱
  • └ is_cap_count_discount_rate
  • Boolean
  • 可选
  • false
  • 是否指定件数整体打折
  • └ is_cap_count_each_fix_price
  • Boolean
  • 可选
  • false
  • 是否指定件数每件一口价
  • cover_all_discount_rule
  • CoverAllDiscountRule
  • 可选
  • 阶梯整体优惠规则
  • └ each_fix_price
  • Number
  • 可选
  • 20
  • 每件商品一口价【分】
  • └ cover_all_discount_rate
  • Number
  • 可选
  • 30
  • 整体打折【600=6折】
  • └ cover_all_decrease_money
  • Number
  • 可选
  • 40
  • 整体减钱【分】
  • └ cover_all_fix_price
  • Number
  • 可选
  • 50
  • 整体一口价【分】
  • └ is_cover_all_fix_price
  • Boolean
  • 可选
  • false
  • 是否整体一口价
  • └ is_cover_all_decrease_money
  • Boolean
  • 可选
  • false
  • 是否整体减钱
  • └ is_cover_all_discount_rate
  • Boolean
  • 可选
  • false
  • 是否整体打折
  • └ is_each_fix_price
  • Boolean
  • 可选
  • false
  • 是否每件一口价
  • count_at_discount_rule
  • CountAtDiscountRule
  • 可选
  • 第N件优惠规则
  • └ count_at_discount_rate
  • Number
  • 可选
  • 2
  • 第N件折扣率【600=6折】
  • └ count_at_decrease_money
  • Number
  • 可选
  • 3
  • 第N件减钱【分】
  • └ count_at_fix_price
  • Number
  • 可选
  • 4
  • 第N件一口价【分】
  • └ is_count_at_fix_price
  • Boolean
  • 可选
  • true
  • 是否第N建一口价
  • └ is_count_at_decrease_money
  • Boolean
  • 可选
  • false
  • 是否第N件减钱
  • └ is_count_at_discount_rate
  • Boolean
  • 可选
  • true
  • 是否第N件打折
  • └ login_group_express
  • String
  • 可选
  • 暂不使用
  • 分组表达式【暂时不使用】
  • └ is_amount
  • Boolean
  • 可选
  • false
  • 是否满元
  • └ is_count
  • Boolean
  • 可选
  • false
  • 是否满件
  • └ number
  • Number
  • 必须
  • 23
  • 阶梯序号,代表商家的阶梯ID,同时代表阶梯优先级的顺序
  • └ amount
  • Number
  • 可选
  • 23
  • 满x元【单位为分】
  • └ count
  • Number
  • 可选
  • 24
  • 满x件
  • └ is_overlay_logic_group_condition
  • Boolean
  • 可选
  • true
  • 是否叠加逻辑分组的条件
  • separate_pricing_discount_rule
  • SeparatePricingDiscountRule
  • 可选
  • 单独定价优惠规则
  • └ is_discount_rate
  • Boolean
  • 可选
  • true
  • 是否为打折类型
  • └ is_decrease
  • Boolean
  • 可选
  • true
  • 是否为减钱类型
  • └ is_fix_price
  • Boolean
  • 可选
  • true
  • 是否为一口价类型
  • activity_rule
  • ActivityRule
  • 可选
  • 活动优惠规则
  • └ ceiling_amount
  • Number
  • 可选
  • 200
  • 封顶金额
  • └ is_multi_mix
  • Boolean
  • 可选
  • false
  • 多阶梯是否可叠加
  • └ item_overlay
  • Boolean
  • 可选
  • true
  • 单商品是否累计
  • └ is_alone
  • Boolean
  • 可选
  • false
  • 是否单商品计数【NY使用】【废弃】
  • └ enable_multiple
  • Boolean
  • 可选
  • true
  • 是否上不封顶
  • └ is_check_all_cond
  • Boolean
  • 可选
  • true
  • 是否叠加计算逻辑分组与阶梯满元【件】条件
  • └ discount_fee_mode
  • Number
  • 可选
  • 1
  • 1-可贬值,0-不可贬值
  • logic_group_rules
  • OpenLogicGroupRule []
  • 可选
  • 逻辑分组规则
  • cover_all_discount_rule
  • CoverAllDiscountRule
  • 可选
  • 整体优惠
  • └ each_fix_price
  • Number
  • 可选
  • 20
  • 每件一口价【分】
  • └ cover_all_discount_rate
  • Number
  • 可选
  • 30
  • 整体打折【分】
  • └ cover_all_decrease_money
  • Number
  • 可选
  • 40
  • 整体减钱【分】
  • └ cover_all_fix_price
  • Number
  • 可选
  • 50
  • 整体一口价【分】
  • └ is_cover_all_fix_price
  • Boolean
  • 可选
  • true
  • 是否整体一口价
  • └ is_cover_all_decrease_money
  • Boolean
  • 可选
  • true
  • 是否整体减钱
  • └ is_cover_all_discount_rate
  • Boolean
  • 可选
  • true
  • 是否整体打折
  • └ is_each_fix_price
  • Boolean
  • 可选
  • true
  • 是否整体每件一口价
  • └ is_effective_group
  • Boolean
  • 可选
  • false
  • 是否为优惠作用分组
  • └ amount
  • Number
  • 可选
  • 12
  • 逻辑分组上满N元条件,当阶梯的is_amount=true时生效,逻辑分组条件的优先级大于阶梯条件的优先级
  • └ count
  • Number
  • 可选
  • 13
  • 逻辑分组上满N件条件,当阶梯的is_count=true时生效,逻辑分组条件的优先级大于阶梯条件的优先级
  • └ can_extra_item_num
  • Number
  • 可选
  • 14
  • 换购N件
  • └ logic_group_type
  • Number
  • 可选
  • 1
  • 1-普通分组,2-换购分组,3-买赠分组
  • └ number
  • Number
  • 可选
  • 2
  • 商家逻辑分组Id(单个活动不能重复)
  • └ exchange_group_order
  • Number
  • 可选
  • 1
  • 换购分组排序,用于在app上展示的顺序
  • └ exchange_group_name
  • String
  • 可选
  • 超值换购分组
  • 换购分组名称
  • └ ratio
  • Number
  • 可选
  • 23
  • 分摊比例
  • └ shop_ids
  • String []
  • 必须
  • [123,456]
  • 参加活动的渠道店ids
  • └ end_time
  • Number
  • 必须
  • 1506513600000
  • 活动结束时间
  • └ start_time
  • Number
  • 必须
  • 340923498
  • 活动开始时间
  • └ description
  • String
  • 必须
  • 618商品池活动
  • 活动描述
  • └ activity_name
  • String
  • 必须
  • 618商品池满30-12
  • 活动标题
  • └ merchant_crowd_code
  • String
  • 可选
  • OLD_USER
  • 商家人群编码
  • └ txd_crowd_code
  • String
  • 可选
  • ~OLD_USER
  • 淘鲜达人群编码
  • └ member_limit
  • Number
  • 可选
  • 1
  • 会员维度活动参与人群限制:-1:不限制 1:会员专享 2:非会员专享
  • └ terminals
  • String []
  • 必须
  • [1,2]
  • 优惠适用场景[APP|POS|POS+APP分别对应的值为1|2|1,2]
  • └ out_act_id
  • String
  • 可选
  • 23123
  • 商家活动id
  • period_config
  • PeriodConfig
  • 可选
  • 周期优惠信息
  • └ every_day_periods
  • String []
  • 可选
  • ["03:00:00_05:00:00"]
  • 每天的什么时间阶段搞活动,精确到秒单位 例如:03:00:00_05:00:00
  • └ weekdays
  • String []
  • 可选
  • [1,5]
  • 星期几搞活动 [1:Mon;2:Tues;3:Wed;4:Thur;5:Fri;6:Sat;7:Sun]
  • └ is_comb
  • Boolean
  • 可选
  • false
  • 是否是组合优惠
  • └ priority_value
  • Number
  • 可选
  • 10
  • 活动优先级,值越大表示优先级越高,必须大于0
  • └ exclude_single
  • Boolean
  • 可选
  • false
  • 商品池是否排除特价
  • └ is_category
  • Boolean
  • 可选
  • false
  • 是否是类目优惠
  • └ by_channel
  • Boolean
  • 可选
  • true
  • 是否自定义渠道同步
  • channel_config_list
  • ChannelConfig []
  • 可选
  • []
  • 自定义同步渠道配置
  • └ channel
  • String
  • 可选
  • 31
  • 淘鲜达:"31",饿了么:"3",京东到家:"26",美团外卖:"2"

响应参数

名称 类型 示例值 描述
message String 请求参数非法 message
fail_code String REQUEST_PARAM_ERROR errorCode
data Number 124135 data
is_success Boolean true success

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaWdkMarketingItempoolActivityCreateRequest req = new AlibabaWdkMarketingItempoolActivityCreateRequest();
AlibabaWdkMarketingItempoolActivityCreateRequest.ItemPoolActivity obj1 = new AlibabaWdkMarketingItempoolActivityCreateRequest.ItemPoolActivity();
AlibabaWdkMarketingItempoolActivityCreateRequest.LimitInfo obj2 = new AlibabaWdkMarketingItempoolActivityCreateRequest.LimitInfo();
obj2.setUserDailyLimitCnt(20L);
obj2.setUserLimitCnt(20L);
obj2.setTotalLimitCnt(20L);
obj2.setDailyLimitCnt(10L);
obj1.setLimitInfo(obj2);
List<AlibabaWdkMarketingItempoolActivityCreateRequest.OpenPromotionRuleStair> list4 = new ArrayList<AlibabaWdkMarketingItempoolActivityCreateRequest.OpenPromotionRuleStair>();
AlibabaWdkMarketingItempoolActivityCreateRequest.OpenPromotionRuleStair obj5 = new AlibabaWdkMarketingItempoolActivityCreateRequest.OpenPromotionRuleStair();
list4.add(obj5);
AlibabaWdkMarketingItempoolActivityCreateRequest.CapCountDiscountRule obj7 = new AlibabaWdkMarketingItempoolActivityCreateRequest.CapCountDiscountRule();
obj7.setCapCountEachFixPrice(20L);
obj7.setCapCountDiscountRate(30L);
obj7.setCapCountDecreaseMoney(40L);
obj7.setCapCountFixPrice(50L);
obj7.setIsCapCountFixPrice(false);
obj7.setIsCapCountDecreaseMoney(false);
obj7.setIsCapCountDiscountRate(false);
obj7.setIsCapCountEachFixPrice(false);
list6.setCapCountDiscountRule(obj7);
AlibabaWdkMarketingItempoolActivityCreateRequest.CoverAllDiscountRule obj9 = new AlibabaWdkMarketingItempoolActivityCreateRequest.CoverAllDiscountRule();
obj9.setEachFixPrice(20L);
obj9.setCoverAllDiscountRate(30L);
obj9.setCoverAllDecreaseMoney(40L);
obj9.setCoverAllFixPrice(50L);
obj9.setIsCoverAllFixPrice(false);
obj9.setIsCoverAllDecreaseMoney(false);
obj9.setIsCoverAllDiscountRate(false);
obj9.setIsEachFixPrice(false);
list8.setCoverAllDiscountRule(obj9);
AlibabaWdkMarketingItempoolActivityCreateRequest.CountAtDiscountRule obj11 = new AlibabaWdkMarketingItempoolActivityCreateRequest.CountAtDiscountRule();
obj11.setCountAtDiscountRate(2L);
obj11.setCountAtDecreaseMoney(3L);
obj11.setCountAtFixPrice(4L);
obj11.setIsCountAtFixPrice(true);
obj11.setIsCountAtDecreaseMoney(false);
obj11.setIsCountAtDiscountRate(true);
list10.setCountAtDiscountRule(obj11);
obj5.setLoginGroupExpress("暂不使用");
obj5.setIsAmount(false);
obj5.setIsCount(false);
obj5.setNumber(23L);
obj5.setAmount(23L);
obj5.setCount(24L);
obj5.setIsOverlayLogicGroupCondition(true);
AlibabaWdkMarketingItempoolActivityCreateRequest.SeparatePricingDiscountRule obj13 = new AlibabaWdkMarketingItempoolActivityCreateRequest.SeparatePricingDiscountRule();
obj13.setIsDiscountRate(true);
obj13.setIsDecrease(true);
obj13.setIsFixPrice(true);
list12.setSeparatePricingDiscountRule(obj13);
obj1.setRuleStairs(list4);
AlibabaWdkMarketingItempoolActivityCreateRequest.ActivityRule obj14 = new AlibabaWdkMarketingItempoolActivityCreateRequest.ActivityRule();
obj14.setCeilingAmount(200L);
obj14.setIsMultiMix(false);
obj14.setItemOverlay(true);
obj14.setIsAlone(false);
obj14.setEnableMultiple(true);
obj14.setIsCheckAllCond(true);
obj14.setDiscountFeeMode(1L);
obj1.setActivityRule(obj14);
List<AlibabaWdkMarketingItempoolActivityCreateRequest.OpenLogicGroupRule> list16 = new ArrayList<AlibabaWdkMarketingItempoolActivityCreateRequest.OpenLogicGroupRule>();
AlibabaWdkMarketingItempoolActivityCreateRequest.OpenLogicGroupRule obj17 = new AlibabaWdkMarketingItempoolActivityCreateRequest.OpenLogicGroupRule();
list16.add(obj17);
AlibabaWdkMarketingItempoolActivityCreateRequest.CoverAllDiscountRule obj19 = new AlibabaWdkMarketingItempoolActivityCreateRequest.CoverAllDiscountRule();
obj19.setEachFixPrice(20L);
obj19.setCoverAllDiscountRate(30L);
obj19.setCoverAllDecreaseMoney(40L);
obj19.setCoverAllFixPrice(50L);
obj19.setIsCoverAllFixPrice(true);
obj19.setIsCoverAllDecreaseMoney(true);
obj19.setIsCoverAllDiscountRate(true);
obj19.setIsEachFixPrice(true);
list18.setCoverAllDiscountRule(obj19);
obj17.setIsEffectiveGroup(false);
obj17.setAmount(12L);
obj17.setCount(13L);
obj17.setCanExtraItemNum(14L);
obj17.setLogicGroupType(1L);
obj17.setNumber(2L);
obj17.setExchangeGroupOrder(1L);
obj17.setExchangeGroupName("超值换购分组");
obj17.setRatio(23L);
obj1.setLogicGroupRules(list16);
obj1.setShopIds("123,456");
obj1.setEndTime(1506513600000L);
obj1.setStartTime(340923498L);
obj1.setDescription("618商品池活动");
obj1.setActivityName("618商品池满30-12");
obj1.setMerchantCrowdCode("OLD_USER");
obj1.setTxdCrowdCode("~OLD_USER");
obj1.setMemberLimit(1L);
obj1.setTerminals("1,2");
obj1.setOutActId("23123");
AlibabaWdkMarketingItempoolActivityCreateRequest.PeriodConfig obj20 = new AlibabaWdkMarketingItempoolActivityCreateRequest.PeriodConfig();
obj20.setEveryDayPeriods(""03:00:00_05:00:00"");
obj20.setWeekdays("1,5");
obj1.setPeriodConfig(obj20);
obj1.setIsComb(false);
obj1.setPriorityValue(10L);
obj1.setExcludeSingle(false);
obj1.setIsCategory(false);
obj1.setByChannel(true);
List<AlibabaWdkMarketingItempoolActivityCreateRequest.ChannelConfig> list22 = new ArrayList<AlibabaWdkMarketingItempoolActivityCreateRequest.ChannelConfig>();
AlibabaWdkMarketingItempoolActivityCreateRequest.ChannelConfig obj23 = new AlibabaWdkMarketingItempoolActivityCreateRequest.ChannelConfig();
list22.add(obj23);
obj23.setChannel("31");
obj1.setChannelConfigList(list22);
req.setParam(obj1);
AlibabaWdkMarketingItempoolActivityCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_wdk_marketing_itempool_activity_create_response>
    <message>请求参数非法</message>
    <fail_code>REQUEST_PARAM_ERROR</fail_code>
    <data>124135</data>
    <is_success>true</is_success>
</alibaba_wdk_marketing_itempool_activity_create_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部