修改视频基本信息

1. 接口描述

URL https://openapi.youku.com/router/rest.json
功能描述 修改视频的基本信息,包括标题、标签、描述等。
返回格式 json,UTF8
HTTP请求方式 GET
是否需要登录
当前接口版本 V3

2. 系统参数

参数名 参数全称 必选 参数类型 参数描述
action action true String youku.api.vod.update.videoinfo
client_id client_id true String 应用的client id
access_token access token false String oauth2的token
timestamp timestamp true String 客户端当前时间戳,精确到秒,timestamp与开放平台请求时间误差为6分钟
version version true String API协议版本,默认值3.0
sign_method sign_method false String 签名的摘要算法,可选值为:HmacSHA256,md5。默认为md5
sign sign true String 对API调用参数(除sign外)的md5加密值。详情见签名方法

3. 业务参数

参数名 参数全称 必选 参数类型 参数描述
_id _id true String 视频信息_id,注:此处做签名时需要排在最前面
title title false String 视频标题
tags tags false String 视频标签
desc desc false String 视频描述
attr_values attr_values false jsonarray 属性值,sid为属性sid,value为属性值
category_id category_id false long 视频所属分类sid
recycled recycled false int 是否进回收站,0表示未进,1表示进
player_id player_id false int 播放器id

4. 返回参数

参数名 参数全称 必选 参数类型 参数描述
error error true object 错误码,参考 error code 描述
fid fid true long 文件id
post_url post_url true string 截图地址
tags tags true String 视频标签
desc desc true string 视频描述
sync_status sync_status true int 同步状态
title title true string 视频标题
_id _id true string 视频id
file_id file_id true string 视频文件id
lut lut true long 最后一次操作时间
status status true int 视频状态 0:上传中,1:正常,2:上传完成,3:转码中,4:转码失败,7:删除
recycled recycled true int 回收站状态
category_id category_id true int 视频分类
property property true int property
check_time check_time true long 审核时间
ct ct true long 创建时间
operator operator true string 操作者id
duration duration true long 视频时长
subcate_id subcate_id true int 子属性
source source true int 视频来源
player_id player_id true int 播放器id
channel channel true int channel

5. 调用示例

https://openapi.youku.com/router/rest.json?opensysparams=
{"action": "youku.api.vod.update.videoinfo", "version": "3.0",
 "format": "json", "client_id": "163d4fd10c7f9a28", "timestamp":
 1466999847, "sign": "a73b7162fb177fb9563b99bb3ab956eb"}
&desc=dscp2&tags=tab2&_id=569c9e7f0cf2ebcd9893f552&title=lx3m.avi
  			

6. 响应示例

{
    "e": {
        "desc": "",
        "provider": "cloudvideo",
        "code": 0
    },
    "data": {
        "fid": 177,
        "tags": "tab2",
        "sid": 288,
        "lock_time": 1466130241,
        "desc": "dscp2",
        "file_size": 1120142,
        "status": 1,
        "recycled": 0,
        "post_url": "http://101.201.172.30/cloudvideo/kservice-route/get.json?fid=05A000009569C9E89000000000EB3C659.png&ns=uvod-thumb.cloud.youku.com&customer_id=55b1e538e4b075d6cceec82c",
        "category_id": 0,
        "property": 1,
        "sync_status": 0,
        "check_time": 1466130328,
        "operator": "57550f710cf26b7b2c6733bd",
        "ct": 1453104767,
        "duration": 36,
        "title": "lx3m.avi",
        "checkStatus": 1,
        "source": 1,
        "subcate_id": 0,
        "_id": "569c9e7f0cf2ebcd9893f552",
        "file_id": "569c9e7f0cf2ebcd9893f551",
        "lut": 1470035164,
        "player_id": 9,
        "channel": 0,
        "customer_id": "55b1e538e4b075d6cceec82c"
    },
    "cost": 0.006000000052154064
}

7. 异常示例

8. 注意事项