通过视频id等参数修改单个视频信息
接口地址(仅做说明使用):https://api.polyv.net/v2/video/%s/video-info
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
@Test
public void testUpdateVideoInfo() throws IOException, NoSuchAlgorithmException {
VodUpdateVideoInfoRequest vodUpdateVideoInfoRequest = new VodUpdateVideoInfoRequest();
VodUpdateVideoInfoResponse vodUpdateVideoInfoResponse = null;
try {
vodUpdateVideoInfoRequest
//可通过 new VodQueryServiceImpl().queryVideoList()获取
.setVideoId(super.getTestVideoId())
.setDesc("这是一个通过junit合并的视频")
.setTag("junit测试");
vodUpdateVideoInfoResponse = new VodEditServiceImpl().updateVideoInfo(vodUpdateVideoInfoRequest);
Assert.assertNotNull(vodUpdateVideoInfoResponse);
if (vodUpdateVideoInfoResponse != null) {
log.debug("测试修改单个视频信息成功,{}", JSON.toJSONString(vodUpdateVideoInfoResponse));
}
} catch (PloyvSdkException e) {
//参数校验不合格 或者 请求服务器端500错误,错误信息见PloyvSdkException.getMessage()
log.error(e.getMessage(), e);
// 异常返回做B端异常的业务逻辑,记录log 或者 上报到ETL 或者回滚事务
throw e;
} catch (Exception e) {
log.error("SDK调用异常", e);
throw e;
}
}
1、请求正确,返回VodUpdateVideoInfoResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
视频截图大图地址【对应api文档的images_b字段】
流畅码率mp4格式视频地址【对应api文档的mp4_1字段】
高清码率mp4格式视频地址【对应api文档的mp4_2字段】
超清码率mp4格式视频地址【对应api文档的mp4_3字段】
分类id, 如1为根目录【对应api文档的cataid字段】
返回flash链接【对应api文档的swf_link字段】
视频状态:60/61已发布;10等待编码;20正在编码;50等待审核;51审核不通过;-1已删除;
流畅码率flv格式视频地址【对应api文档的flv1字段】
高清码率flv格式视频地址【对应api文档的flv2字段】
超清码率flv格式视频地址【对应api文档的flv3字段】
源文件【对应api文档的sourcefile字段】
视频宽度【对应api文档的playerwidth字段】
用户默认播放视频【对应api文档的default_video字段】
视频首图【对应api文档的first_image字段】
最佳分辨率【对应api文档的original_definition字段】
视频高度【对应api文档的playerheight字段】
源文件大小【对应api文档的source_filesize字段】
md5校验值【对应api文档的md5checksum字段】
编码后各个清晰度视频的m3u8地址,类型为array
是否为源文件,否:0,是:1【对应api文档的keepsource字段】
加密等级 open:非授权加密 web:web授权 app:app授权 wxa_app:小程序授权
Uploader参数描述
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
多个视频id,用英文逗号隔开(状态为半角),例如 1b8be3,239c2e【对应api文档的vids字段】
是否开启,0:关闭,1:开启,默认为开启【对应api文档的playauth字段】
true为修改成功,false为修改失败
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
加密授权参数,值为open/web/app/wxa_app之一,open为开放授权,web为WEB授权,app为APP授权,wxa_app为小程序授权【对应api文档的hlslevel字段】
多个视频的vid,用英文逗号隔开【对应api文档的vids字段】
true为修改视频授权方式成功,false为修改授权方式失败
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
true为设置成功,false为设置失败
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. ]
视频vid,多个视频以英文逗号分隔【对应api文档的vids字段】
true为设置成功,false为设置失败
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
视频ID,多个使用英文逗号分隔【对应api文档的vids字段】
true为修改成功,false为删除失败
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
视频的ID,可以选择多个视频,逗号分割,例如 e2e85038_e,e2e85039_e【对应api文档的vids字段】
视频将要移动到的目标分类ID【对应api文档的cataid字段】
true为修改成功,false为修改失败
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、接口支持批量恢复,一次性最多支持恢复100个视频。
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
点播视频videoId,多个使用英文逗号分隔【对应api文档的vids字段】
true为恢复成功,false为恢复失败
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、视频id一次最多提交500个;
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
视频ID,多个视频以英文逗号(,)隔开,一次最多提交500个【对应api文档的vids字段】
删除方式,1:删除到回收站,2:彻底删除,默认为:1
true为批量删除成功,false为批量删除失败