文档中心 > API类目 > 淘宝客API

taobao.tbk.content.material.save (淘宝客-公用-爆料分享物料上传)

爆料分享物料上传,服务商和推广者都可用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
add_on_items String 可选 pBdZOatxtA2JAatxRHptm-M8X3qWt4MK8mpxtB 凑单商品id,多个英文逗号分隔
boom_start_time Date 可选 2023-01-01 00:00:00 优惠价开始时间
boom_end_time Date 可选 2023-01-01 00:00:00 优惠价结束时间
text_materials String 必须 文字素材 素材文字部分
cont_id String 可选 媒体内容Id 媒体内容Id
price_tag String 可选 全网好价 价格力标签
title String 必须 奥妙洗衣液50g*2瓶优惠价9.9元 爆料标题
discount_rank String 可选 A 折扣等级
professional_tag Number 可选 0 官方ip标签 0-88vip,1-淘金币,2-百亿补贴,3-天猫超市,4-天猫国际自营
scene Number 必须 1 场景id。1:优惠导购-一淘特供 2:优惠导购-一淘 3:优惠导购-淘宝联盟-社群 4:优惠导购-淘宝联盟-朋友圈 5:优惠导购-淘宝联盟-APP 6:优惠导购-淘宝联盟 7:推广素材-淘宝联盟
item_discount_count Number 可选 2 优惠价格主商品需购件数
positive_feedback_count Number 可选 100 点赞数(值)
offline_code Number 可选 0 下线操作字段 ,该字段入参表示内容失效不可继续使用,仅限修改入参,首次上传不可传入。 0-已涨价 1-售罄 2-失效 3-其他需下架原因
boom_price String 可选 9.99 爆料价格(两位小数)
boom_type Number 必须 1 爆料类型 1:商品;2:活动
content_type Number 必须 1 内容类型,1:实时单 2:预告单
price_structure String 可选 买2件打5折 价格实现方式
publisher_nick_name String 可选 每日好物推荐 原作者昵称
negative_feedback_count Number 可选 100 点踩数(不值)
origin_time Date 可选 2023-01-01 00:00:00 原作者发布时间
content_tag String 可选 母婴好物 内容标签
pre_commission_rate String 可选 15 预告佣金率,仅预告单可传入
coupon_url String 可选 https://uland.taobao.com 优惠券链接
selling_point String 可选 有效除菌,气味清新 商品卖点
boom_id Number 可选 855 爆料id,当接口操作为“2:更新”必传
item_id String 可选 qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9 商品id,爆料类型为“1:商品”时 必传
activity_url String 可选 https://s.click.taobao.com 活动链接,爆料类型为“2:活动”时 必传
pic_materials String 必须 abc 素材图片部分,base64编码,多张用英文逗号分隔
publisher_avatar String 可选 abc 原作者头像,base64编码
operation Number 必须 2 接口操作,1:上传,2:更新
pre_view_pic String 可选 abc 商品预览图,base64编码
content_generate_type Number 可选 1 1:UGC 2:MGC

响应参数

名称 类型 示例值 描述
data BoomContentResultDTO 结果出参
  • boom_content_dto
  • BoomContentDTO
  • 单个爆料内容
  • └ boom_id
  • Number
  • 855
  • 爆料id
  • └ operation
  • Number
  • 1
  • 操作类型,1-上传;2-更新
result_code Number 500 异常code
biz_error_desc Number 审核中数据不可更改 业务异常描述
result_msg String 内部服务发生错误 异常描述
biz_error_code Number 2056 业务异常code

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkContentMaterialSaveRequest req = new TbkContentMaterialSaveRequest();
req.setAddOnItems("pBdZOatxtA2JAatxRHptm-M8X3qWt4MK8mpxtB");
req.setBoomStartTime(StringUtils.parseDateTime("2023-01-01 00:00:00"));
req.setBoomEndTime(StringUtils.parseDateTime("2023-01-01 00:00:00"));
req.setTextMaterials("文字素材");
req.setContId("媒体内容Id");
req.setPriceTag("全网好价");
req.setTitle("奥妙洗衣液50g*2瓶优惠价9.9元");
req.setDiscountRank("A");
req.setProfessionalTag(0L);
req.setScene(1L);
req.setItemDiscountCount(2L);
req.setPositiveFeedbackCount(100L);
req.setOfflineCode(0L);
req.setBoomPrice("9.99");
req.setBoomType(1L);
req.setContentType(1L);
req.setPriceStructure("买2件打5折");
req.setPublisherNickName("每日好物推荐");
req.setNegativeFeedbackCount(100L);
req.setOriginTime(StringUtils.parseDateTime("2023-01-01 00:00:00"));
req.setContentTag("母婴好物");
req.setPreCommissionRate("15");
req.setCouponUrl("https://uland.taobao.com");
req.setSellingPoint("有效除菌,气味清新");
req.setBoomId(855L);
req.setItemId("qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9");
req.setActivityUrl("https://s.click.taobao.com");
req.setPicMaterials("abc");
req.setPublisherAvatar("abc");
req.setOperation(2L);
req.setPreViewPic("abc");
req.setContentGenerateType(1L);
TbkContentMaterialSaveResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_content_material_save_response>
    <data>
        <boom_content_dto>
            <boom_id>855</boom_id>
        </boom_content_dto>
        <operation>1</operation>
    </data>
    <result_code>500</result_code>
    <biz_error_desc>审核中数据不可更改</biz_error_desc>
    <result_msg>内部服务发生错误</result_msg>
    <biz_error_code>2056</biz_error_code>
</tbk_content_material_save_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

返回
顶部