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

taobao.ovs.tbk.dg.optimus.material (海外淘宝客-推广者-物料精选)

支持入参对应的“推广位”和官方提供的“物料id”,面向海外推广者获取指定物料信息和推广链接

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
adzone_id Number 必须 1234 mm_xxx_xxx_xxx的第三位
page_no Number 可选 1 第几页,默认:1
page_size Number 可选 20 页大小,默认20,1~100
material_id Number 必须 1234 海外官方的物料Id

响应参数

名称 类型 示例值 描述
items ItemDto [] 淘宝客商品
  • └ tpwd
  • String
  • 8緮置内容¥hxlgccEumBB¥达开?τao寶?或掂击炼接 https://m.tb.cn/h.VvkiWSm 至浏.览览.器【618超级红包】
  • 淘口令
  • └ click_url
  • String
  • http://s.click.taobao.com/ABC
  • 淘客推广链接
  • └ price
  • String
  • 1.23
  • 商品价格
  • └ commission
  • String
  • 1.23
  • 商品预估佣金
  • └ commission_rate
  • String
  • 6.4
  • 商品佣金比率
  • └ pict_url
  • String
  • //img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg
  • 商品主图地址
  • └ title
  • String
  • 秋季短裤
  • 商品标题
  • └ item_id
  • String
  • 1234
  • 商品ID

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OvsTbkDgOptimusMaterialRequest req = new OvsTbkDgOptimusMaterialRequest();
req.setAdzoneId(1234L);
req.setPageNo(1L);
req.setPageSize(20L);
req.setMaterialId(1234L);
OvsTbkDgOptimusMaterialResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ovs_tbk_dg_optimus_material_response>
    <items>
        <item_dto>
            <tpwd>8緮置内容¥hxlgccEumBB¥达开?τao寶?或掂击炼接 https://m.tb.cn/h.VvkiWSm 至浏.览览.器【618超级红包】</tpwd>
            <click_url>http://s.click.taobao.com/ABC</click_url>
            <price>1.23</price>
            <commission>1.23</commission>
            <commission_rate>6.4</commission_rate>
            <pict_url>//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</pict_url>
            <title>秋季短裤</title>
            <item_id>1234</item_id>
        </item_dto>
    </items>
</ovs_tbk_dg_optimus_material_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>

错误码解释

错误码 错误描述 解决方案
501 ILLEGAL_INPUT_ADZONE_ID 检查adzone_id参数
503 ILLEGAL_INPUT_MATERIAL_ID 检查material_id参数
502 ILLEGAL_INPUT_PAGE_PARAM 检查页相关参数
550 MIX ERROR 请检查adzone_id或者海外开放平台taobao user id和海外联盟平台不一致
0 SYSTEM_ERROR 请重试

API工具

如何获得此API

FAQ

返回
顶部