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

taobao.vmac.singlevideo.get (获取单个短视频)

通过视频ID获取单个短视频

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
source_type String 必须 YOUKU 来源类型
video_id String 必须 XMzEzOTI3NjY0 视频ID

响应参数

名称 类型 示例值 描述
result ResultDto result
  • └ detail_message
  • String
  • 成功
  • 详细消息。
  • value
  • SingleVideoItemResultDto
  • value
  • video
  • SingleVideoOuterDto
  • 视频对象
  • └ video_id
  • String
  • XMzEzOTI3NjY0
  • 视频ID
  • └ source_type
  • String
  • YOUKU
  • sourceType
  • └ title
  • String
  • 大国
  • 视频标题
  • └ rc_title
  • String
  • 大国
  • 视频推荐标题
  • └ status
  • String
  • 发布
  • 视频状态
  • └ category
  • String
  • 电影
  • 视频分类
  • └ duration
  • String
  • 200
  • 视频时长(秒)
  • └ thumb_url
  • String
  • http://r4.ykimg.com/0542040850F5600E6A0A4364D75D7F74
  • 视频截图
  • └ panorama
  • Boolean
  • false
  • 是否全景
  • └ description
  • String
  • 介绍中国...
  • 视频简介
  • └ definition_list
  • String []
  • ["DEF_NORMAL","DEF_HIGH","DEF_SUPER"]
  • 清晰度列表,DEF_FLUENCY=流畅清晰度,DEF_NORMAL=普通清晰度,DEF_HIGH=高清清晰度,DEF_SUPER=超清/720P清晰度,DEF_FHD=超高清/1080P清晰度,DEF_4K=4K清晰度
  • └ language_list
  • String []
  • 国语
  • 语言列表
  • └ sub_category
  • String
  • 华语、流行
  • 二级分类
  • └ episode_count
  • String
  • 1
  • 总集数
  • └ paid
  • Number
  • 0
  • 是否收费 0:免费 1:收费
  • └ tags
  • String
  • 张学友,如果爱,歌舞电影
  • 标签
  • └ singer
  • String
  • 张学友、游鸿明
  • 歌手
  • └ vthumb_url
  • String
  • 竖海报地址
  • 竖海报
  • └ show_subtitle
  • String
  • 大国
  • 副标题
  • └ showseq
  • String
  • 1
  • 当前集数
  • └ area
  • String
  • 中国
  • 地区
  • └ show_id
  • String
  • virtual_showId_62DZXZJL772K
  • 节目id
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ code
  • String
  • SUCCESS
  • 错误码
  • └ message
  • String
  • 成功
  • 消息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
VmacSinglevideoGetRequest req = new VmacSinglevideoGetRequest();
req.setSourceType("YOUKU");
req.setVideoId("XMzEzOTI3NjY0");
VmacSinglevideoGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<vmac_singlevideo_get_response>
    <result>
        <detail_message>成功</detail_message>
        <value>
            <video>
                <video_id>XMzEzOTI3NjY0</video_id>
                <source_type>YOUKU</source_type>
                <title>大国</title>
                <rc_title>大国</rc_title>
                <status>发布</status>
                <category>电影</category>
                <duration>200</duration>
                <thumb_url>http://r4.ykimg.com/0542040850F5600E6A0A4364D75D7F74</thumb_url>
                <panorama>false</panorama>
                <description>介绍中国...</description>
                <definition_list>
                    <string>[&quot;DEF_NORMAL&quot;</string>
                    <string>&quot;DEF_HIGH&quot;</string>
                    <string>&quot;DEF_SUPER&quot;]</string>
                </definition_list>
                <language_list>
                    <string>国语</string>
                </language_list>
                <sub_category>华语、流行</sub_category>
                <episode_count>1</episode_count>
                <paid>0</paid>
                <tags>张学友,如果爱,歌舞电影</tags>
                <singer>张学友、游鸿明</singer>
                <vthumb_url>竖海报地址</vthumb_url>
                <show_subtitle>大国</show_subtitle>
                <showseq>1</showseq>
                <area>中国</area>
                <show_id>virtual_showId_62DZXZJL772K</show_id>
            </video>
        </value>
        <success>true</success>
        <code>SUCCESS</code>
        <message>成功</message>
    </result>
</vmac_singlevideo_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

返回
顶部