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

taobao.tbk.optimus.tou.material.ids.get (淘宝客-推广者-物料id列表查询)

获取为该推广者提供的所有物料id列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
material_query MaterialQuery 可选 请求结构
  • └ page_no
  • Number
  • 可选
  • 1
  • 页码,默认1,取值范围1~100
  • └ subject
  • Number
  • 必须
  • 1
  • 物料主题类型, 1促销活动;2热门主题;3精选榜单;4行业频道等;5其他
  • └ material_type
  • Number
  • 必须
  • 1
  • 物料类型,1: 商品;2:权益
  • └ page_size
  • Number
  • 可选
  • 20
  • 每页物料id数量,默认20,取值范围1~100

响应参数

名称 类型 示例值 描述
data TouMaterials [] 返回结果
  • └ material_name
  • String
  • "test"
  • 物料集合名称
  • └ material_id
  • Number
  • 123456
  • 物料id
  • └ material_type
  • Number
  • 1
  • 物料类型,1: 商品;2:权益
  • └ subject
  • Number
  • 1
  • 物料主题类型, 1促销活动;2热门主题;3精选榜单;4行业频道等;5其他
  • └ start_time
  • Number
  • 1660875853
  • 开始时间,Unix时间戳
  • └ end_time
  • Number
  • 1660875853
  • 结束时间,Unix时间戳
total_count Number 20 物料id总数
result_msg String "test" 结果描述信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkOptimusTouMaterialIdsGetRequest req = new TbkOptimusTouMaterialIdsGetRequest();
TbkOptimusTouMaterialIdsGetRequest.MaterialQuery obj1 = new TbkOptimusTouMaterialIdsGetRequest.MaterialQuery();
obj1.setPageNo(1L);
obj1.setSubject(1L);
obj1.setMaterialType(1L);
obj1.setPageSize(20L);
req.setMaterialQuery(obj1);
TbkOptimusTouMaterialIdsGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_optimus_tou_material_ids_get_response>
    <data>
        <tou_materials>
            <material_name>&quot;test&quot;</material_name>
            <material_id>123456</material_id>
            <material_type>1</material_type>
            <subject>1</subject>
            <start_time>1660875853</start_time>
            <end_time>1660875853</end_time>
        </tou_materials>
    </data>
    <total_count>20</total_count>
    <result_msg>&quot;test&quot;</result_msg>
</tbk_optimus_tou_material_ids_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

返回
顶部