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

taobao.tbk.dg.media.month.report (淘宝客-推广者-媒体月报(媒体维度))

内容平台域媒体,可查询媒体账号维度的月度统计数据。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 可选 20 每页大小
page_no Number 可选 1 页码
dimensions String 可选 ds 聚合条件
filters String 可选 div_rule=1;ds=201903 查询条件:div_rule=1(扣费6个点及以上汇总);div_rule=2(扣费1到6个点之间)
return_fields String 可选 total_alipay_amt,pub_id,div_rule,settle_amount 查询字段,目前开放的固定值
report_type_id String 可选 union_media_month_report 月报报表名称,固定值

响应参数

名称 类型 示例值 描述
page_info Pageinfo map 分页信息
  • └ page_size
  • Number
  • 20
  • 每页大小
  • └ page_no
  • Number
  • 1
  • 页数
  • └ total_cnt
  • Number
  • 100
  • 总数
report_type_id String union_media_month_report 报表名称
data_list MapData [] map数组 结果列表
  • └ total_alipay_amt
  • String
  • 41232141231.14
  • 结算订单金额
  • └ settle_amount
  • String
  • 1321314241.42
  • 实际打款结算金额
  • └ pub_id
  • Number
  • 124125
  • 媒体平台memberid
  • └ div_rule
  • String
  • 1
  • 1-佣金6%或以上结算类型;2-佣金6%以下结算类型

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDgMediaMonthReportRequest req = new TbkDgMediaMonthReportRequest();
req.setPageSize(20L);
req.setPageNo(1L);
req.setDimensions("ds");
req.setFilters("div_rule=1;ds=201903");
req.setReturnFields("total_alipay_amt,pub_id,div_rule,settle_amount");
req.setReportTypeId("union_media_month_report");
TbkDgMediaMonthReportResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_dg_media_month_report_response>
    <page_info>
        <page_size>20</page_size>
        <page_no>1</page_no>
        <total_cnt>100</total_cnt>
    </page_info>
    <report_type_id>union_media_month_report</report_type_id>
    <data_list>
        <map_data>
            <total_alipay_amt>41232141231.14</total_alipay_amt>
            <settle_amount>1321314241.42</settle_amount>
            <pub_id>124125</pub_id>
            <div_rule>1</div_rule>
        </map_data>
    </data_list>
</tbk_dg_media_month_report_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

返回
顶部