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

taobao.tbk.dg.reports.query.click (淘宝客-推广者-媒体数据交换报表点击维度)

报表查询API(导购)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 必须 20 每页大小
page_no Number 必须 1 页码
dimensions String 可选 ds 聚合条件
filters String 必须 ds=20190723 查询条件
return_fields String 可选 name 查询字段
report_type_id String 必须 union_media_3rd_click 报表名称

响应参数

名称 类型 示例值 描述
data_list MapData [] map数组 结果列表
  • └ click_id
  • String
  • 1234
  • 点击id
report_type_id String union_media_3rd_click 报表名称
page_info RptPageinfo map 分页信息
  • └ total_cnt
  • Number
  • 20
  • 总数
  • └ page_no
  • Number
  • 1
  • 页数
  • └ page_size
  • Number
  • 100
  • 每页大小

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDgReportsQueryClickRequest req = new TbkDgReportsQueryClickRequest();
req.setPageSize(20L);
req.setPageNo(1L);
req.setDimensions("ds");
req.setFilters("ds=20190723");
req.setReturnFields("name");
req.setReportTypeId("union_media_3rd_click");
TbkDgReportsQueryClickResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_dg_reports_query_click_response>
    <data_list>
        <map_data>
            <click_id>1234</click_id>
        </map_data>
    </data_list>
    <report_type_id>union_media_3rd_click</report_type_id>
    <page_info>
        <total_cnt>20</total_cnt>
        <page_no>1</page_no>
        <page_size>100</page_size>
    </page_info>
</tbk_dg_reports_query_click_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>

错误码解释

错误码 错误描述 解决方案
1001 非法的me参数值 传入正确的me参数值,含有券ID与商品ID信息
10000 该itemId对应的宝贝已下架或非淘客宝贝 更换新的itemId查询
4 查询不到对应的adzoneId,请检查adzoneId是否正确 查询不到对应的adzoneId,请检查adzoneId是否正确
30002 参数q与cat不能都为空 参数q与cat不能都为空
2 pid不正确,请检查是否输入了正确的adzoneId和siteId pid不正确,请检查是否输入了正确的adzoneId和siteId
40001 内部调用失败 联系开发人员
50001 无结果 无结果
30001 非法的物料id 非法的物料id

API工具

如何获得此API

FAQ

返回
顶部