文档中心 > API类目 > 海外-淘宝客API

taobao.ovs.tbk.favitem.get (获取选品库数据)

获取选品库数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
unid String 可选 test123 自定义输入串,英文和数字组成,长度不能大于12个字符,区分不同的推广渠道
adzone_id Number 必须 108858100157 推广位id,需要在淘宝联盟后台创建
group_id Number 必须 100000047001 海外联盟Pub平台选品库ID

响应参数

名称 类型 示例值 描述
group_title String 精选 选品库标题
total_count Number 100 选品库总数量
items ItemDTO [] 商品信息
  • └ item_id
  • String
  • 1233234
  • 商品ID
  • └ category_name
  • String
  • 牛仔裤
  • 商品信息-叶子类目名称
  • └ category_id
  • Number
  • 111
  • 商品信息-叶子类目id
  • └ pict_url
  • String
  • http://gi4.md.alicdn.com/bao/uploaded/i4/xxx.jpg
  • 商品主图
  • └ title
  • String
  • 连衣裙
  • 商品标题
  • └ shop_title
  • String
  • XXXX旗舰店
  • 店铺信息-店铺名称
  • └ volume
  • String
  • 123
  • 商品信息-30天销量
  • └ reserve_price
  • String
  • 10.1
  • 商品原价
  • └ price_after_coupon
  • String
  • 9.0
  • 商品券后价
  • └ zk_final_price
  • String
  • 10
  • 折扣价(元) 若属于预售商品,付定金时间内,折扣价=预售价
  • └ commission_rate
  • String
  • 5.5
  • 商品信息-佣金比率(%)
  • └ click_url
  • String
  • http://s.click.taobao.com/e=xxx
  • 链接
  • └ coupon_share_url
  • String
  • //uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8
  • 链接-宝贝+券二合一页面链接
  • └ coupon_end_time
  • String
  • 2020-10-01 23:59:59
  • 优惠券结束时间
  • └ coupon_start_time
  • String
  • 2020-10-01 00:00:00
  • 优惠券开始时间
  • └ coupon_info
  • String
  • 满200-20
  • 优惠券信息面额
  • └ coupon_total_count
  • Number
  • 30000
  • 优惠券信息-优惠券总量
  • └ coupon_remain_count
  • Number
  • 100
  • 优惠券剩余量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OvsTbkFavitemGetRequest req = new OvsTbkFavitemGetRequest();
req.setUnid("test123");
req.setAdzoneId(108858100157L);
req.setGroupId(100000047001L);
OvsTbkFavitemGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ovs_tbk_favitem_get_response>
    <group_title>精选</group_title>
    <total_count>100</total_count>
    <items>
        <item_d_t_o>
            <item_id>1233234</item_id>
            <category_name>牛仔裤</category_name>
            <category_id>111</category_id>
            <pict_url>http://gi4.md.alicdn.com/bao/uploaded/i4/xxx.jpg</pict_url>
            <title>连衣裙</title>
            <shop_title>XXXX旗舰店</shop_title>
            <volume>123</volume>
            <reserve_price>10.1</reserve_price>
            <price_after_coupon>9.0</price_after_coupon>
            <zk_final_price>10</zk_final_price>
            <commission_rate>5.5</commission_rate>
            <click_url>http://s.click.taobao.com/e=xxx</click_url>
            <coupon_share_url>//uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&amp;mt=1&amp;app_pvid=0ab0fac715095507006577956e&amp;ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8</coupon_share_url>
            <coupon_end_time>2020-10-01 23:59:59</coupon_end_time>
            <coupon_start_time>2020-10-01 00:00:00</coupon_start_time>
            <coupon_info>满200-20</coupon_info>
            <coupon_total_count>30000</coupon_total_count>
            <coupon_remain_count>100</coupon_remain_count>
        </item_d_t_o>
    </items>
</ovs_tbk_favitem_get_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

返回
顶部