注意:以下文档只适用于TOP接口,请谨慎使用!

taobao.caipiao.marketing.put (创建或修改商家送彩票活动)

卖家通过此接口新增或修改送彩票活动的配置,比如活动时间、活动的条件等。 店铺装修、宝贝详情页的宣导素材示例: https://gw.alicdn.com/tfs/TB1_nOiSXXXXXbgXXXXXXXXXXXX-750-280.png https://gw.alicdn.com/tfs/TB1FZX6SXXXXXXzXFXXXXXXXXXX-790-280.png https://gw.alicdn.com/tfs/TB1z4t8SXXXXXckXpXXXXXXXXXX-750-280.png https://gw.alicdn.com/tfs/TB1BhqgSXXXXXcDXXXXXXXXXXXX-750-280.png https://gw.alicdn.com/tfs/TB1TYt9SXXXXXXAXFXXXXXXXXXX-750-280.png https://gw.alicdn.com/tfs/TB1tzpNSXXXXXacXVXXXXXXXXXX-790-280.png https://gw.alicdn.com/tfs/TB1UXdxSXXXXXXsapXXXXXXXXXX-790-280.png https://gw.alicdn.com/tfs/TB1_gV.SXXXXXbZXpXXXXXXXXXX-790-280.png

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
detail WangcaiMarketingDetail 必须 活动详情设置
  • └ activity_id
  • String
  • 必须
  • 12345678
  • 活动ID,一个活动可以关联多个送彩票设置
  • └ lottery_type_id
  • Number
  • 必须
  • 1
  • 赠送的彩种,1双色球/8大乐透
  • └ min_amount
  • Number
  • 必须
  • 9900
  • 活动的最小金额门槛,以分为单位
  • └ items
  • Number []
  • 可选
  • [1234,5678]
  • 参与活动的商品ID
  • └ begin_time
  • Date
  • 必须
  • 2017-06-01 00:00:00
  • 活动开始时间
  • └ quantity
  • Number
  • 必须
  • 1
  • 赠送的彩票注数
  • └ activity_type
  • Number
  • 必须
  • 0
  • 活动类型,0全店/1指定商品
  • └ end_time
  • Date
  • 必须
  • 2017-07-01 00:00:00
  • 活动结束时间
  • └ activity_name
  • String
  • 必须
  • 满送彩票活动
  • 活动名称
  • └ biz_id
  • String
  • 必须
  • 1234567890
  • 外部系统主键

响应参数

名称 类型 示例值 描述
result Boolean true 业务操作结果,true成功/false失败

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CaipiaoMarketingPutRequest req = new CaipiaoMarketingPutRequest();
CaipiaoMarketingPutRequest.WangcaiMarketingDetail obj1 = new CaipiaoMarketingPutRequest.WangcaiMarketingDetail();
obj1.setActivityId("12345678");
obj1.setLotteryTypeId(1L);
obj1.setMinAmount(9900L);
obj1.setItems(new Long[] { 1234,5678 };
);
obj1.setBeginTime(StringUtils.parseDateTime("2017-06-01 00:00:00"));
obj1.setQuantity(1L);
obj1.setActivityType(0L);
obj1.setEndTime(StringUtils.parseDateTime("2017-07-01 00:00:00"));
obj1.setActivityName("满送彩票活动");
obj1.setBizId("1234567890");
req.setDetail(obj1);
CaipiaoMarketingPutResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<caipiao_marketing_put_response>
    <result>true</result>
</caipiao_marketing_put_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

返回
顶部