文档中心 > API类目 > 多媒体平台API

taobao.isv.video.add (保存视频)

保存视频

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
isv String 必须 isv.qnfw 识别服务商的代码code
video_do VideoDo 必须 视频对象
  • └ user_id
  • Number
  • 必须
  • 0
  • 上传者Id
  • └ tag_str
  • String
  • 可选
  • {"美妆"}
  • 视频标签
  • └ is_need_authenticate
  • Boolean
  • 可选
  • false
  • 默认不可见
  • └ state
  • Number
  • 可选
  • 0
  • 默认不可见
  • └ parent_nick
  • String
  • 可选
  • nick
  • 默认不可见
  • └ play_url_pc
  • String
  • 可选
  • -
  • 默认不可见
  • └ parent_id
  • Number
  • 可选
  • 0
  • 默认不可见
  • └ title
  • String
  • 必须
  • 女装视频
  • 视频标题
  • └ description
  • String
  • 可选
  • 视频描述信息
  • 视频描述
  • └ video_id
  • Number
  • 可选
  • 0
  • 默认不可见
  • └ length
  • Number
  • 可选
  • 0
  • 默认不可见
  • └ features
  • String
  • 可选
  • {"qn":"11"}
  • 视频属性 json格式
  • └ main_pic_url
  • String
  • 可选
  • http://1.jpg
  • 主图封面
  • └ upload_date
  • Date
  • 可选
  • 2018-01-01 00:00:00
  • 默认不可见
  • └ options
  • Number
  • 可选
  • 4
  • 默认不可见
  • └ sync_le_tao
  • Number
  • 可选
  • 0
  • 默认不可见
  • └ tags
  • String []
  • 可选
  • 视频标签
  • 视频标签
  • └ synced
  • Number
  • 可选
  • 0
  • 默认不可见
  • └ cover_url
  • String
  • 必须
  • http://2.jpg
  • 封面图
  • └ category_id
  • Number
  • 可选
  • 0
  • 默认不可见
  • └ is_contain_ad
  • Boolean
  • 可选
  • false
  • 默认不可见
  • └ item_id
  • Number
  • 可选
  • 0
  • 默认不可见
  • └ is_open_to_other
  • Boolean
  • 可选
  • false
  • 默认不可见
  • └ play_url_ios
  • String
  • 可选
  • -
  • 默认不可见
  • └ group_id
  • Number
  • 可选
  • 0
  • 默认不可见
  • └ upload_id
  • String
  • 可选
  • -
  • 默认不可见
file_id String 必须 015e-xxxx-xxxx-xxxx 文件Id

响应参数

名称 类型 示例值 描述
result ResultDo result
  • └ model
  • Number
  • 12345
  • 视频Id
  • └ result_code
  • String
  • add video
  • 结果码
  • └ success
  • Boolean
  • true
  • success
  • └ messages
  • String []
  • 保存视频成功
  • messages

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
IsvVideoAddRequest req = new IsvVideoAddRequest();
req.setIsv("isv.qnfw");
IsvVideoAddRequest.VideoDo obj1 = new IsvVideoAddRequest.VideoDo();
obj1.setUserId(0L);
obj1.setTagStr("{\"美妆\"}");
obj1.setIsNeedAuthenticate(false);
obj1.setState(0L);
obj1.setParentNick("nick");
obj1.setPlayUrlPc("-");
obj1.setParentId(0L);
obj1.setTitle("女装视频");
obj1.setDescription("视频描述信息");
obj1.setVideoId(0L);
obj1.setLength(0L);
obj1.setFeatures("{\"qn\":\"11\"}");
obj1.setMainPicUrl("http://1.jpg");
obj1.setUploadDate(StringUtils.parseDateTime("2018-01-01 00:00:00"));
obj1.setOptions(4L);
obj1.setSyncLeTao(0L);
obj1.setTags("视频标签");
obj1.setSynced(0L);
obj1.setCoverUrl("http://2.jpg");
obj1.setCategoryId(0L);
obj1.setIsContainAd(false);
obj1.setItemId(0L);
obj1.setIsOpenToOther(false);
obj1.setPlayUrlIos("-");
obj1.setGroupId(0L);
obj1.setUploadId("-");
req.setVideoDo(obj1);
req.setFileId("015e-xxxx-xxxx-xxxx");
IsvVideoAddResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<isv_video_add_response>
    <result>
        <model>12345</model>
        <result_code>add video</result_code>
        <success>true</success>
        <messages>
            <string>保存视频成功</string>
        </messages>
    </result>
</isv_video_add_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

返回
顶部