taobao.ump.activity.add (新增优惠活动)

新增优惠活动。设置优惠活动的基本信息,比如活动时间,活动针对的对象(可以是满足某些条件的买家)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tool_id Number 必须 12345 工具id
content String 必须 {'name':'test','desc':'test'} 活动内容,通过ump sdk里面的MarkeitngTool来生成,name必须属于“营销标签词库”——https://huodong.m.taobao.com/api/data/v2/5fe5e737d3314fa2973297f86f7bff3a.js?file=5fe5e737d3314fa2973297f86f7bff3a.js中的word值中的一种。

响应参数

名称 类型 示例值 描述
act_id Number 123456 活动id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UmpActivityAddRequest req = new UmpActivityAddRequest();
req.setToolId(12345L);
req.setContent("{'name':'test','desc':'test'}");
UmpActivityAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ump_activity_add_response>
    <act_id>123456</act_id>
</ump_activity_add_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>

错误码解释

错误码 错误描述 解决方案
isv.tool-not-exist 优惠工具已经失效或者被删除 传入正确有效的优惠工具id
isv.activity-count-exceeds-max-number 活动数超过最大限制 清理无效活动后重新操作

API工具

如何获得此API

FAQ

返回
顶部