Edit Service
1、修改单个视频信息
描述
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
单元测试
单元测试说明
1、请求正确,返回VodUpdateVideoInfoResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
videoId
true
String
视频ID【对应api文档的vid字段】
desc
false
String
视频描述【对应api文档的describ字段】
publishUrl
false
String
视频首发外链地址
tag
false
String
视频标签
title
false
String
视频标题
返回对象描述
imagesBig
String[]
视频截图大图地址【对应api文档的images_b字段】
images
String[]
视频截图小图地址
tag
String
视频标签
title
String
视频标题
df
Integer
视频码率数
times
String
播放次数
videoId
String
视频id【对应api文档的vid字段】
SDMp4
String
流畅码率mp4格式视频地址【对应api文档的mp4_1字段】
HDmp4
String
高清码率mp4格式视频地址【对应api文档的mp4_2字段】
FHDmp4
String
超清码率mp4格式视频地址【对应api文档的mp4_3字段】
categoryId
String
分类id, 如1为根目录【对应api文档的cataid字段】
swfLink
String
返回flash链接【对应api文档的swf_link字段】
status
String
视频状态:60/61已发布;10等待编码;20正在编码;50等待审核;51审核不通过;-1已删除;
seed
Integer
加密视频为1,非加密为0
SDFlv
String
流畅码率flv格式视频地址【对应api文档的flv1字段】
HDFlv
String
高清码率flv格式视频地址【对应api文档的flv2字段】
FHDFlv
String
超清码率flv格式视频地址【对应api文档的flv3字段】
sourceFile
String
源文件【对应api文档的sourcefile字段】
playerWidth
String
视频宽度【对应api文档的playerwidth字段】
defaultVideo
String
用户默认播放视频【对应api文档的default_video字段】
duration
String
视频时长,如:00:00:48
firstImage
String
视频首图【对应api文档的first_image字段】
originalDefinition
String
最佳分辨率【对应api文档的original_definition字段】
context
String
视频描述
playerHeight
String
视频高度【对应api文档的playerheight字段】
uploadTime
String
上传时间【对应api文档的ptime字段】
sourceFilesize
String
源文件大小【对应api文档的source_filesize字段】
filesize
String[]
编码后各个清晰度视频的文件大小,类型为array
md5Checksum
String
md5校验值【对应api文档的md5checksum字段】
hls
String[]
编码后各个清晰度视频的m3u8地址,类型为array
keepSource
String
是否为源文件,否:0,是:1【对应api文档的keepsource字段】
hlsLevel
String
加密等级 open:非授权加密 web:web授权 app:app授权 wxa_app:小程序授权
categoryName
String
分类名称【对应api文档的cataname字段】
String
上传者邮箱
name
String
上传者名称
role
String
上传者角色,如管理员,上传者,主账号
2、修改视频的授权播放开关
描述
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
单元测试
单元测试说明
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
videoIds
true
String
多个视频id,用英文逗号隔开(状态为半角),例如 1b8be3,239c2e【对应api文档的vids字段】
playAuth
false
Integer
是否开启,0:关闭,1:开启,默认为开启【对应api文档的playauth字段】
返回对象描述
true为修改成功,false为修改失败
3、批量修改视频的授权方式
描述
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
单元测试
单元测试说明
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
hlsLevel
true
String
加密授权参数,值为open/web/app/wxa_app之一,open为开放授权,web为WEB授权,app为APP授权,wxa_app为小程序授权【对应api文档的hlslevel字段】
videoIds
true
String
多个视频的vid,用英文逗号隔开【对应api文档的vids字段】
返回对象描述
true为修改视频授权方式成功,false为修改授权方式失败
4、修改视频的播放预览时长
描述
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
单元测试
单元测试说明
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
videoId
true
String
视频ID【对应api文档的vid字段】
duration
true
Integer
预览的时长(单位是秒),例如:20
返回对象描述
true为设置成功,false为设置失败
5、修改视频禁播与解禁开关
描述
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、禁播后会将视频状态(status)设置成53,一次最多只能操作500个vid
3、只能修改”已发布”状态的视频为禁播状态,只能修改“已禁播”状态的视频为已发布状态
4、当请求中的视频包含多种状态时,只对符合条件的视频进行状态修改操作,并返回成功;若没有符合条件的vid则返回错误。
单元测试
单元测试说明
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
videoIds
true
String
视频vid,多个视频以英文逗号分隔【对应api文档的vids字段】
forbidden
true
Integer
1:禁播,0:解禁
返回对象描述
true为设置成功,false为设置失败
6、修改视频密码
描述
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
单元测试
单元测试说明
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
videoIds
true
String
视频ID,多个使用英文逗号分隔【对应api文档的vids字段】
desc
false
String
视频描述【对应api文档的describ字段】
password
false
String
视频密码
publishUrl
false
String
首发外链
tag
false
String
视频标签
title
false
String
视频标题
返回对象描述
true为修改成功,false为删除失败
7、移动视频到指定分类
描述
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
单元测试
单元测试说明
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
videoIds
true
String
视频的ID,可以选择多个视频,逗号分割,例如 e2e85038_e,e2e85039_e【对应api文档的vids字段】
categoryId
true
String
视频将要移动到的目标分类ID【对应api文档的cataid字段】
返回对象描述
true为修改成功,false为修改失败
8、恢复回收站视频
描述
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、接口支持批量恢复,一次性最多支持恢复100个视频。
单元测试
单元测试说明
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
videoIds
true
String
点播视频videoId,多个使用英文逗号分隔【对应api文档的vids字段】
返回对象描述
true为恢复成功,false为恢复失败
9、批量删除视频
描述
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、视频id一次最多提交500个;
单元测试
单元测试说明
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
videoIds
true
String
视频ID,多个视频以英文逗号(,)隔开,一次最多提交500个【对应api文档的vids字段】
deleteType
false
Integer
删除方式,1:删除到回收站,2:彻底删除,默认为:1
返回对象描述
true为批量删除成功,false为批量删除失败
Last updated
Was this helpful?