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

alibaba.hm.marketing.itemdiscount.createactivity (创建商品特价活动)

创建商品特价活动

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param ItemDiscountActivityRequest 必须 创建活动请求入参
  • └ start_time
  • Number
  • 必须
  • 1503835200000
  • 活动开始时间,时间戳
  • └ terminals
  • String []
  • 必须
  • [1,2]
  • 优惠适用场景[APP|POS|POS+APP分别对应的值为1|2|1,2]
  • └ discount_type
  • String
  • 必须
  • itemFixPrice
  • 商品特价优惠方式[itemDecreaseMoney:商品特价减钱;itemFixPrice:商品特价一口价;itemDiscount:商品特价打折]
  • └ description
  • String
  • 必须
  • 特价活动描述
  • 活动详情描述,不超过30个英文字符
  • └ out_act_id
  • String
  • 可选
  • sanjiang170907
  • 商家活动id
  • └ shop_ids
  • String []
  • 必须
  • [123,456]
  • 参加活动的渠道店ids
  • └ end_time
  • Number
  • 必须
  • 1506513600000
  • 活动结束时间,时间戳
  • └ activity_name
  • String
  • 必须
  • 特价活动名称
  • 活动名称,不超过10个英文字符
  • └ member_limit
  • Number
  • 可选
  • 1
  • 会员维度活动参与人群限制[-1:不限制;1:会员专享;2:非会员专享]
  • └ merchant_crowd_code
  • String
  • 可选
  • OLD_USER
  • 商家人群编码
  • └ txd_crowd_code
  • String
  • 可选
  • ~OLD_USER
  • 淘鲜达人群编码
  • └ activity_channel
  • String
  • 可选
  • darunfa
  • 渠道编码
  • period_config
  • PeriodConfig
  • 可选
  • 周期优惠信息
  • └ every_day_periods
  • String []
  • 可选
  • [1,5]
  • 每天的那些时间段生效
  • └ weekdays
  • String []
  • 可选
  • ["03:00:00_05:00:00"]
  • 一周的哪几天生效
  • └ priority_value
  • Number
  • 可选
  • 10
  • 活动优先级,值越大表示优先级越高,必须大于0
  • └ cover_before
  • Boolean
  • 可选
  • false
  • 是否参加后单压前单,默认不参加
  • └ by_channel
  • Boolean
  • 可选
  • true
  • 是否自定义渠道同步
  • channel_config_list
  • ChannelConfig []
  • 可选
  • 自定义同步的渠道配置
  • └ channel
  • String
  • 可选
  • 31
  • 淘鲜达:"31",饿了么:"3",京东到家:"26",美团外卖:"2"

响应参数

名称 类型 示例值 描述
result MarketResult 创建活动返回结果
  • └ message
  • String
  • 请求参数非法
  • 错误信息
  • └ error_code
  • String
  • REQUEST_PARAM_ERROR
  • 错误码
  • └ data
  • Number
  • 124135
  • 创建成功时会返回五道口活动id
  • └ success
  • Boolean
  • true
  • 创建活动是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaHmMarketingItemdiscountCreateactivityRequest req = new AlibabaHmMarketingItemdiscountCreateactivityRequest();
AlibabaHmMarketingItemdiscountCreateactivityRequest.ItemDiscountActivityRequest obj1 = new AlibabaHmMarketingItemdiscountCreateactivityRequest.ItemDiscountActivityRequest();
obj1.setStartTime(1503835200000L);
obj1.setTerminals("1,2");
obj1.setDiscountType("itemFixPrice");
obj1.setDescription("特价活动描述");
obj1.setOutActId("sanjiang170907");
obj1.setShopIds("123,456");
obj1.setEndTime(1506513600000L);
obj1.setActivityName("特价活动名称");
obj1.setMemberLimit(1L);
obj1.setMerchantCrowdCode("OLD_USER");
obj1.setTxdCrowdCode("~OLD_USER");
obj1.setActivityChannel("darunfa");
AlibabaHmMarketingItemdiscountCreateactivityRequest.PeriodConfig obj2 = new AlibabaHmMarketingItemdiscountCreateactivityRequest.PeriodConfig();
obj2.setEveryDayPeriods("1,5");
obj2.setWeekdays(""03:00:00_05:00:00"");
obj1.setPeriodConfig(obj2);
obj1.setPriorityValue(10L);
obj1.setCoverBefore(false);
obj1.setByChannel(true);
List<AlibabaHmMarketingItemdiscountCreateactivityRequest.ChannelConfig> list4 = new ArrayList<AlibabaHmMarketingItemdiscountCreateactivityRequest.ChannelConfig>();
AlibabaHmMarketingItemdiscountCreateactivityRequest.ChannelConfig obj5 = new AlibabaHmMarketingItemdiscountCreateactivityRequest.ChannelConfig();
list4.add(obj5);
obj5.setChannel("31");
obj1.setChannelConfigList(list4);
req.setParam(obj1);
AlibabaHmMarketingItemdiscountCreateactivityResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_hm_marketing_itemdiscount_createactivity_response>
    <result>
        <message>请求参数非法</message>
        <error_code>REQUEST_PARAM_ERROR</error_code>
        <data>124135</data>
        <success>true</success>
    </result>
</alibaba_hm_marketing_itemdiscount_createactivity_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

返回
顶部