文档中心 > API类目 > 天猫精灵开放API

alibaba.ailabs.aligenie.playreport.queryresult (天猫精灵播放报表数据查询结果获取接口)

天猫精灵提供给合作方的播放明细数据报表查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
task_key String 可选 XXXXXX 查询请求Key

响应参数

名称 类型 示例值 描述
result PlayReportResult 查询结果
  • └ status
  • Number
  • 0
  • 查询任务状态3:请求不存在;2:正在查询中;1:查询失败;0:查询成功
  • datas
  • PlayReport []
  • 播放明细
  • └ normal_play_pv
  • String
  • 2711
  • 有内容总时长的播放pv,完整播放率的分母,单位:次
  • └ play_pv
  • Number
  • 2712
  • 播放pv,单位:次
  • └ play_time
  • String
  • 1340369.3790000002
  • 播放总时长,单位:秒
  • └ valid_play_pv
  • Number
  • 2170
  • 有效播放pv,单位:次
  • └ audio_name
  • String
  • 莫扎特-油菜花开
  • 音频名称
  • └ valid_play_rate
  • String
  • 0.8001474926253688
  • 有效播放率,单位:%
  • └ over_play_rate
  • String
  • 0.7037993360383622
  • 完整播放率,单位:%
  • └ audio_id
  • String
  • ADAGMX1AwDTUX
  • 音频ID
  • └ over_play_pv
  • Number
  • 1908
  • 完整播放pv,单位:次
  • └ stat_date
  • String
  • 20190127
  • 日期,格式yymmdd

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAilabsAligeniePlayreportQueryresultRequest req = new AlibabaAilabsAligeniePlayreportQueryresultRequest();
req.setTaskKey("XXXXXX");
AlibabaAilabsAligeniePlayreportQueryresultResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ailabs_aligenie_playreport_queryresult_response>
    <result>
        <status>0</status>
        <datas>
            <play_report>
                <normal_play_pv>2711</normal_play_pv>
                <play_pv>2712</play_pv>
                <play_time>1340369.3790000002</play_time>
                <valid_play_pv>2170</valid_play_pv>
                <audio_name>莫扎特-油菜花开</audio_name>
                <valid_play_rate>0.8001474926253688</valid_play_rate>
                <over_play_rate>0.7037993360383622</over_play_rate>
                <audio_id>ADAGMX1AwDTUX</audio_id>
                <over_play_pv>1908</over_play_pv>
                <stat_date>20190127</stat_date>
            </play_report>
        </datas>
    </result>
</alibaba_ailabs_aligenie_playreport_queryresult_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

返回
顶部