taobao.promotion.benefit.activity.relation (关联活动权益)

卖家活动中需要通过该API来关联的对应的权益。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
relation_request RelationActivityBenefitRequest 必须 活动关联权益请求参数
  • add_detail_vos
  • ActivityBenefitDetailVo []
  • 可选
  • 活动关联的权益信息,可以从权益选择器API中获取
  • └ benefit_id
  • Number
  • 必须
  • 123
  • 权益ID
  • └ benefit_type
  • String
  • 可选
  • ALIPAY_COUPON
  • 权益类型
  • └ config_id
  • Number
  • 可选
  • 1
  • 权益标识
  • benefit_activity_vo
  • BenefitActivityVo
  • 必须
  • 同步权益活动的概述信息,用于卖家后台查看
  • └ activity_url
  • String
  • 可选
  • http://www.taobao.com
  • ISV活动的具体地址
  • └ desc
  • String
  • 可选
  • demo
  • 活动描述
  • └ end_time
  • Date
  • 必须
  • 2015-05-29 12:02:49
  • 活动结束时间
  • └ name
  • String
  • 必须
  • demo
  • 活动名称
  • └ start_time
  • Date
  • 必须
  • 2015-05-29 12:02:49
  • 活动的开始时间
  • └ type
  • String
  • 必须
  • SEND
  • 活动类型

响应参数

名称 类型 示例值 描述
relation_id Number 1234 活动关联ID
is_success Boolean true 请求是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PromotionBenefitActivityRelationRequest req = new PromotionBenefitActivityRelationRequest();
PromotionBenefitActivityRelationRequest.RelationActivityBenefitRequest obj1 = new PromotionBenefitActivityRelationRequest.RelationActivityBenefitRequest();
List<PromotionBenefitActivityRelationRequest.ActivityBenefitDetailVo> list3 = new ArrayList<PromotionBenefitActivityRelationRequest.ActivityBenefitDetailVo>();
PromotionBenefitActivityRelationRequest.ActivityBenefitDetailVo obj4 = new PromotionBenefitActivityRelationRequest.ActivityBenefitDetailVo();
list3.add(obj4);
obj4.setBenefitId(123L);
obj4.setBenefitType("ALIPAY_COUPON");
obj4.setConfigId(1L);
obj1.setAddDetailVos(list3);
PromotionBenefitActivityRelationRequest.BenefitActivityVo obj5 = new PromotionBenefitActivityRelationRequest.BenefitActivityVo();
obj5.setActivityUrl("http://www.taobao.com");
obj5.setDesc("demo");
obj5.setEndTime(StringUtils.parseDateTime("2015-05-29 12:02:49"));
obj5.setName("demo");
obj5.setStartTime(StringUtils.parseDateTime("2015-05-29 12:02:49"));
obj5.setType("SEND");
obj1.setBenefitActivityVo(obj5);
req.setRelationRequest(obj1);
PromotionBenefitActivityRelationResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<promotion_benefit_activity_relation_response>
    <relation_id>1234</relation_id>
    <is_success>true</is_success>
</promotion_benefit_activity_relation_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.invalid-parameter:291 关联的活动名称过长 小于40个字符
isp.service-unknown-error:247 捕获的一些未预知的错误异常。 稍后重试,如果仍然失败可联系接口开发排查。
isp.thread-limit:102 接口访问量过大被流控。 降低访问频率或者等系统空闲时候访问。
isp.service-unknown-error:108 捕获的一些未预知的错误异常。 稍后重试,如果仍然失败可联系接口开发排查。
isv.invalid-parameter:257 开始时间晚于结束时间 开始时间早于结束时间
isv.invalid-parameter:292 活动描述过长 不能超过256个字符
isv.invalid-parameter:293 活动URL过长 不能超过100个字符
isv.invalid-parameter:256 活动关联的权益超过5个 删除多余的关联权益
isv.invalid-parameter:259 关联了无效权益 关联的权益已经删除或者已过期
isv.invalid-parameter:2012 权益不存在或权益不可用 检查一下权益是否过期或没有余量了
isv.invalid-parameter:311 权益已经被锁定 权益已经被其他的活动独占,如果确实要关联该权益,到对应的系统中进行解锁操作

API工具

如何获得此API

FAQ

返回
顶部