文档中心 > API类目 > 淘宝买菜

taobao.freshx.promotion.activity.create (创建营销活动)

创建营销活动

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param CreateCouponDo 可选 创建优惠券
  • └ sub_store_list
  • Number []
  • 可选
  • [1,2,3]
  • 子站信息
  • └ description
  • String
  • 必须
  • desc
  • 描述信息
  • └ store_id
  • Number
  • 必须
  • 1
  • 主站id
  • └ title
  • String
  • 必须
  • 天降红包
  • 活动名称
  • └ type
  • Number
  • 必须
  • 1
  • 活动类型1-天降红包
  • creator_user
  • User
  • 可选
  • 创建人
  • └ user_nick
  • String
  • 必须
  • 菜菜
  • 创建人nick
  • └ client_ip
  • String
  • 可选
  • 127.0.1
  • 客户端ip
  • └ user_id
  • String
  • 必须
  • 11
  • 创建人id
  • coupon_list
  • BenefitDO []
  • 可选
  • 优惠券列表
  • └ channel_inventory
  • Number
  • 必须
  • 10
  • 优惠券渠道发放数量
  • └ template_code
  • Number
  • 必须
  • 123456
  • 优惠券code
  • └ coupon_type
  • Number
  • 必须
  • 413001
  • 优惠券类型
  • crowd_list
  • CrowdDo []
  • 可选
  • 权益配置的人群列表,指定后会覆盖券模板上面的人群配置
  • └ extra
  • String
  • 可选
  • 保留
  • 扩展字段
  • └ crowd_id
  • String
  • 可选
  • 4654
  • 人群id
  • └ type
  • Number
  • 可选
  • 3
  • 人群类型 1-新人 2-老客 3-指定人群
  • └ start_time
  • Date
  • 可选
  • 2020-03-01 00:00:00
  • 活动开始时间
  • └ outer_id
  • String
  • 可选
  • 1111
  • 外部业务编号
  • └ end_time
  • Date
  • 可选
  • 2020-03-31 00:00:00
  • 活动结束时间
  • └ status
  • Number
  • 可选
  • 0
  • 活动状态
  • modifier_user
  • User
  • 可选
  • 修改人
  • └ user_nick
  • String
  • 必须
  • 菜菜
  • 修改人nick
  • └ client_ip
  • String
  • 可选
  • 127.0.0.1
  • 客户端ip
  • └ user_id
  • String
  • 必须
  • 1
  • 修改人id
  • └ limit_count
  • Number
  • 必须
  • 1
  • 限领数量
  • └ limit_type
  • String
  • 必须
  • WIN_LIMIT
  • 限领类型
  • crowd_list
  • CrowdDo []
  • 可选
  • 投放计划配置的人群列表
  • └ extra
  • String
  • 可选
  • 保留
  • 扩展字段
  • └ crowd_id
  • String
  • 可选
  • 464
  • 人群ID
  • └ type
  • Number
  • 可选
  • 3
  • 人群类型 1-新人 2-老客 3-指定人群

响应参数

名称 类型 示例值 描述
result PromotionActivityResult 结果
  • └ activity_id
  • Number
  • 123456
  • 活动id
  • └ strategy_code
  • String
  • xxxx
  • 投放code

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FreshxPromotionActivityCreateRequest req = new FreshxPromotionActivityCreateRequest();
FreshxPromotionActivityCreateRequest.CreateCouponDo obj1 = new FreshxPromotionActivityCreateRequest.CreateCouponDo();
obj1.setSubStoreList(new Long[] { 1,2,3 };
);
obj1.setDescription("desc");
obj1.setStoreId(1L);
obj1.setTitle("天降红包");
obj1.setType(1L);
FreshxPromotionActivityCreateRequest.User obj2 = new FreshxPromotionActivityCreateRequest.User();
obj2.setUserNick("菜菜");
obj2.setClientIp("127.0.1");
obj2.setUserId("11");
obj1.setCreatorUser(obj2);
List<FreshxPromotionActivityCreateRequest.BenefitDO> list4 = new ArrayList<FreshxPromotionActivityCreateRequest.BenefitDO>();
FreshxPromotionActivityCreateRequest.BenefitDO obj5 = new FreshxPromotionActivityCreateRequest.BenefitDO();
list4.add(obj5);
obj5.setChannelInventory(10L);
obj5.setTemplateCode(123456L);
obj5.setCouponType(413001L);
List<FreshxPromotionActivityCreateRequest.CrowdDo> list8 = new ArrayList<FreshxPromotionActivityCreateRequest.CrowdDo>();
FreshxPromotionActivityCreateRequest.CrowdDo obj9 = new FreshxPromotionActivityCreateRequest.CrowdDo();
list8.add(obj9);
obj9.setExtra("保留");
obj9.setCrowdId("4654");
obj9.setType(3L);
list6.setCrowdList(list8);
obj1.setCouponList(list4);
obj1.setStartTime(StringUtils.parseDateTime("2020-03-01 00:00:00"));
obj1.setOuterId("1111");
obj1.setEndTime(StringUtils.parseDateTime("2020-03-31 00:00:00"));
obj1.setStatus(0L);
FreshxPromotionActivityCreateRequest.User obj10 = new FreshxPromotionActivityCreateRequest.User();
obj10.setUserNick("菜菜");
obj10.setClientIp("127.0.0.1");
obj10.setUserId("1");
obj1.setModifierUser(obj10);
obj1.setLimitCount(1L);
obj1.setLimitType("WIN_LIMIT");
List<FreshxPromotionActivityCreateRequest.CrowdDo> list12 = new ArrayList<FreshxPromotionActivityCreateRequest.CrowdDo>();
FreshxPromotionActivityCreateRequest.CrowdDo obj13 = new FreshxPromotionActivityCreateRequest.CrowdDo();
list12.add(obj13);
obj13.setExtra("保留");
obj13.setCrowdId("464");
obj13.setType(3L);
obj1.setCrowdList(list12);
req.setParam(obj1);
FreshxPromotionActivityCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<freshx_promotion_activity_create_response>
    <result>
        <activity_id>123456</activity_id>
        <strategy_code>xxxx</strategy_code>
    </result>
</freshx_promotion_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

返回
顶部