文档中心 > API类目 > 电影票API

taobao.film.terminal.adinfo.get (机具广告下发接口)

机具广告下发接口,机具客户端通过该接口实现广告的监测

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
partner_no String 可选 taijiu 供应商编号
terminal_id String 可选 TB0001 机具编号

响应参数

名称 类型 示例值 描述
data AdInfoResponse data 返回的数据实体
  • ad_infos
  • AdInfo []
  • ad_infos
  • 广告信息列表
  • └ ad_id
  • Number
  • 123
  • 广告id
  • └ area
  • String
  • A
  • 广告资源播放的区域:A-屏保界面,B-取票界面上方
  • └ end_time
  • Date
  • 2015-12-26 23:48:00
  • 播放结束时间(广告的有效结束时间)
  • └ md5_code
  • String
  • 8d704fa7473773013945a3087bd66d5d
  • 广告文件的完整性校验md5码
  • └ operate
  • String
  • ISSUING
  • 需要针对该条广告做的操作:ISSUING-需要下发的新增广告或更新,DELETING-需要删除的已失效的广告
  • └ play_time
  • Number
  • 15
  • 广告播放时长,单位(秒),该字段只针对图片起效,对于视频,播放完毕后切换,忽略该值
  • └ start_time
  • Date
  • 2015-11-26 23:48:00
  • 播放开始时间(广告的有效起始时间)
  • └ type
  • String
  • PICTURE
  • 文件类型:PICTURE-图片,VIDEO-视频
  • └ url
  • String
  • http://aliyun.oss.com/aaa.jpg
  • 广告的下载地址
  • └ version
  • Number
  • 3
  • 发布版本号,解决后台重新发布与前端下载延时的冲突问题
  • └ ad_open
  • Boolean
  • false
  • 广告启用开关,true-显示自定义广告,false-所有广告禁播,显示默认屏保
  • └ interval
  • Number
  • 10
  • 接口调用频率,单位(分)
result_code String 1001 交易错误码
result_desc String 数据不存在 交易错误描述信息
status Number 1 交易是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmTerminalAdinfoGetRequest req = new FilmTerminalAdinfoGetRequest();
req.setPartnerNo("taijiu");
req.setTerminalId("TB0001");
FilmTerminalAdinfoGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_terminal_adinfo_get_response>
    <data>
        <ad_infos>
            <ad_info>
                <ad_id>123</ad_id>
                <area>A</area>
                <end_time>2015-12-26 23:48:00</end_time>
                <md5_code>8d704fa7473773013945a3087bd66d5d</md5_code>
                <operate>ISSUING</operate>
                <play_time>15</play_time>
                <start_time>2015-11-26 23:48:00</start_time>
                <type>PICTURE</type>
                <url>http://aliyun.oss.com/aaa.jpg</url>
                <version>3</version>
            </ad_info>
        </ad_infos>
        <ad_open>false</ad_open>
        <interval>10</interval>
    </data>
    <result_code>1001</result_code>
    <result_desc>数据不存在</result_desc>
    <status>1</status>
</film_terminal_adinfo_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

返回
顶部