文档中心 > API类目 > 数娱媒资输出

taobao.vmac.mediamessage.gets (获取媒资消息)

获取媒资节目和视频变更的消息。 使用说明: 当offset值为0值或者不传此值,即可以开始分页或者最近5天内的所有消息。当需要获取下一页内容时,需要使用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
offset Number 可选 123
  • 默认值:0
  • 偏移量
    page_size Number 可选 20
  • 默认值:20
  • 分页大小,不超过100

    响应参数

    名称 类型 示例值 描述
    result ResultDto - result
    • └ code
    • String
    • INVALID_PARAMETER
    • code
    • └ detail_message
    • String
    • null input
    • detailMessage
    • └ message
    • String
    • 成功
    • message
    • └ success
    • Boolean
    • true
    • success
    • value
    • MediaMessagePageResultDto
    • -
    • 数据详情
    • message_list
    • MediaMessageOuterDto []
    • -
    • 消息列表
    • └ offset
    • Number
    • 123
    • 偏移量
    • └ show_id
    • String
    • lwi912lka
    • 节目id
    • └ time_stamp
    • Date
    • 2016-11-12
    • 时间戳
    • └ type
    • String
    • SHOW
    • 消息类型 SHOW VIDEO
    • └ video_id
    • String
    • 123
    • 视频id
    • └ video_source_type
    • String
    • YOUKU
    • 视频来源
    • └ max_offset
    • Number
    • 54678656
    • 当前最大偏移量
    • └ min_offset
    • Number
    • 54671234
    • 当前最小偏移量

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    VmacMediamessageGetsRequest req = new VmacMediamessageGetsRequest();
    req.setOffset(123L);
    req.setPageSize(20L);
    VmacMediamessageGetsResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <vmac_mediamessage_gets_response>
        <result>
            <code>INVALID_PARAMETER</code>
            <detail_message>null input</detail_message>
            <message>成功</message>
            <success>true</success>
            <value>
                <message_list>
                    <media_message_outer_dto>
                        <offset>123</offset>
                        <show_id>lwi912lka</show_id>
                        <time_stamp>2016-11-12</time_stamp>
                        <type>SHOW</type>
                        <video_id>123</video_id>
                        <video_source_type>YOUKU</video_source_type>
                    </media_message_outer_dto>
                </message_list>
                <max_offset>54678656</max_offset>
                <min_offset>54671234</min_offset>
            </value>
        </result>
    </vmac_mediamessage_gets_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>

    错误码解释

    错误码 错误描述 解决方案
    SYSTEM_ERROR 系统错误 请联系家庭娱乐媒资开发,并提供错误信息排查。

    API工具

    如何获得此API

    FAQ

    返回
    顶部