1、修改单个视频信息
描述
通过视频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. ]
请求入参描述
返回对象描述
Uploader参数描述
2、修改视频的授权播放开关
描述
通过视频id修改单个视频或多个视频的授权播放开关状态
接口地址(仅做说明使用):https://api.polyv.net/v2/video/%s/authplay-status
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
单元测试
@Test
public void testUpdateVideoPlayStatus() throws IOException, NoSuchAlgorithmException {
VodUpdateVideoPlayStatusRequest vodUpdateVideoPlayStatusRequest = new VodUpdateVideoPlayStatusRequest();
Boolean vodUpdateVideoPlayStatusResponse = null;
try {
vodUpdateVideoPlayStatusRequest
//可通过 new VodQueryServiceImpl().queryVideoList()获取
.setVideoIds("1b448be3238618df117f9302327f28d6_1").setPlayAuth(1);
vodUpdateVideoPlayStatusResponse = new VodEditServiceImpl().updateVideoPlayStatus(
vodUpdateVideoPlayStatusRequest);
Assert.assertTrue(vodUpdateVideoPlayStatusResponse);
if (vodUpdateVideoPlayStatusResponse) {
log.debug("测试修改视频的授权播放开关成功");
}
} 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、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
返回对象描述
true为修改成功,false为修改失败
3、批量修改视频的授权方式
描述
通过视频id与加密授权参数批量修改视频的授权方式
接口地址(仅做说明使用):https://api.polyv.net/v2/config/%s/hlslevel
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
单元测试
@Test
public void testUpdateVideoHlsLevelList() throws IOException, NoSuchAlgorithmException {
VodUpdateVideoHlsLevelListRequest vodUpdateVideoHlsLevelListRequest = new VodUpdateVideoHlsLevelListRequest();
Boolean vodUpdateVideoHlsLevelListResponse = null;
try {
vodUpdateVideoHlsLevelListRequest
//可通过 new VodQueryServiceImpl().queryVideoList()获取
.setVideoIds(super.getTestVideoId()).setHlsLevel("open");
vodUpdateVideoHlsLevelListResponse = new VodEditServiceImpl().updateVideoHlsLevelList(
vodUpdateVideoHlsLevelListRequest);
Assert.assertTrue(vodUpdateVideoHlsLevelListResponse);
if (vodUpdateVideoHlsLevelListResponse) {
log.debug("测试批量修改视频的授权方式成功");
}
} 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、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
返回对象描述
true为修改视频授权方式成功,false为修改授权方式失败
4、修改视频的播放预览时长
描述
1、通过视频id修改视频的预览时长。
2、使用点播后台视频列表,选择视频,复制右侧预览代码即可播放预览视频
接口地址(仅做说明使用):https://api.polyv.net/v2/video/%s/set-preview-duration
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
单元测试
@Test
public void testSetVideoPreviewDuration() throws IOException, NoSuchAlgorithmException {
VodSetVideoPreviewDurationRequest vodSetVideoPreviewDurationRequest = new VodSetVideoPreviewDurationRequest();
Boolean vodSetVideoPreviewDurationResponse = null;
try {
vodSetVideoPreviewDurationRequest
//可通过 new VodQueryServiceImpl().queryVideoList()获取
.setVideoId(super.getTestVideoId()).setDuration(60);
vodSetVideoPreviewDurationResponse = new VodEditServiceImpl().setVideoPreviewDuration(
vodSetVideoPreviewDurationRequest);
Assert.assertTrue(vodSetVideoPreviewDurationResponse);
if (vodSetVideoPreviewDurationResponse) {
log.debug("测试修改视频的播放预览时长成功");
}
} 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、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
返回对象描述
true为设置成功,false为设置失败
5、修改视频禁播与解禁开关
描述
通过视频id修改视频禁播与解禁状态
接口地址(仅做说明使用):https://api.polyv.net/v2/video/%s/forbidden
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、禁播后会将视频状态(status)设置成53,一次最多只能操作500个vid
3、只能修改”已发布”状态的视频为禁播状态,只能修改“已禁播”状态的视频为已发布状态
4、当请求中的视频包含多种状态时,只对符合条件的视频进行状态修改操作,并返回成功;若没有符合条件的vid则返回错误。
单元测试
@Test
public void testSetVideoForbidden() throws IOException, NoSuchAlgorithmException {
VodSetVideoForbiddenRequest vodSetVideoForbiddenRequest = new VodSetVideoForbiddenRequest();
Boolean vodSetVideoForbiddenResponse = null;
try {
vodSetVideoForbiddenRequest
//可通过 new VodQueryServiceImpl().queryVideoList()获取
.setVideoIds(super.getTestVideoId()).setForbidden(0);
vodSetVideoForbiddenResponse = new VodEditServiceImpl().setVideoForbidden(vodSetVideoForbiddenRequest);
Assert.assertTrue(vodSetVideoForbiddenResponse);
if (vodSetVideoForbiddenResponse) {
log.debug("测试修改视频禁播与解禁开关成功");
}
} 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、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
返回对象描述
true为设置成功,false为设置失败
6、修改视频密码
描述
通过视频id批量修改视频密码
接口地址(仅做说明使用):https://api.polyv.net/v2/video/%s/video-setting-save
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
单元测试
@Test
public void testUpdateVideoSetting() throws IOException, NoSuchAlgorithmException {
VodUpdateVideoSettingRequest vodUpdateVideoSettingRequest = new VodUpdateVideoSettingRequest();
Boolean vodUpdateVideoSettingResponse = null;
try {
vodUpdateVideoSettingRequest
//可通过 new VodQueryServiceImpl().queryVideoList()获取
.setVideoIds("1b448be32355403dad586f7468e63e23_1,1b448be323a9076c9941604ac1c667f9_1")
.setPassword(super.getRandomString(10))
.setPublishUrl(null)
.setTag("junit")
.setTitle("junit测试");
vodUpdateVideoSettingResponse = new VodEditServiceImpl().updateVideoSetting(vodUpdateVideoSettingRequest);
Assert.assertTrue(vodUpdateVideoSettingResponse);
if (vodUpdateVideoSettingResponse) {
log.debug("测试修改视频密码成功");
}
} 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、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
返回对象描述
true为修改成功,false为删除失败
7、移动视频到指定分类
描述
通过视频id与分类id移动视频到指定分类
接口地址(仅做说明使用):https://api.polyv.net/v2/video/%s/changeCata
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
单元测试
@Test
public void testMoveVideo() throws IOException, NoSuchAlgorithmException {
VodMoveVideoRequest vodMoveVideoRequest = new VodMoveVideoRequest();
Boolean vodMoveVideoResponse = null;
try {
vodMoveVideoRequest.setCategoryId("1602671097888").setVideoIds(super.getTestVideoId());
vodMoveVideoResponse = new VodCategoryServiceImpl().moveVideo(vodMoveVideoRequest);
Assert.assertTrue(vodMoveVideoResponse);
if (vodMoveVideoResponse) {
log.debug("测试移动视频到指定分类成功");
}
} 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、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
返回对象描述
true为修改成功,false为修改失败
8、恢复回收站视频
描述
通过视频id批量恢复回收站中的视频
接口地址(仅做说明使用):https://api.polyv.net/v2/video/%s/recover-videos
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、接口支持批量恢复,一次性最多支持恢复100个视频。
单元测试
@Test
public void testRecoverDelList() throws IOException, NoSuchAlgorithmException {
VodRecoverDelListRequest vodRecoverDelListRequest = new VodRecoverDelListRequest();
Boolean vodRecoverDelListResponse = null;
try {
vodRecoverDelListRequest
//可通过 new VodListServiceImpl().getDelList()获取
.setVideoIds("1b448be3232a3206fbbf59f58594d428_1,1b448be32302cab82e0189d115beedd8_1");
vodRecoverDelListResponse = new VodEditServiceImpl().recoverDelList(vodRecoverDelListRequest);
Assert.assertTrue(vodRecoverDelListResponse);
if (vodRecoverDelListResponse) {
log.debug("测试恢复回收站视频成功");
}
} 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、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
返回对象描述
true为恢复成功,false为恢复失败
9、批量删除视频
描述
1、通过视频id批量删除视频
2、删除分为逻辑删除与物理删除,逻辑删除可通过恢复回收站视频接口恢复被删除的视频,而物理删除则不可恢复
接口地址(仅做说明使用):https://api.polyv.net/v2/video/del-videos
调用约束
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、视频id一次最多提交500个;
单元测试
@Test
public void testDeleteVideoList() throws IOException, NoSuchAlgorithmException {
VodDeleteVideoListRequest vodDeleteVideolistRequest = new VodDeleteVideoListRequest();
Boolean vodDeleteVideoListResponse = null;
try {
vodDeleteVideolistRequest
//可通过 new VodQueryServiceImpl().queryVideoList()获取
.setVideoIds("1b448be3238ae0aa1020ac2807c9e8c9_1,1b448be323c12aa5e048c3fb5e10ca99_1")
.setDeleteType(1);
vodDeleteVideoListResponse = new VodEditServiceImpl().deleteVideoList(vodDeleteVideolistRequest);
Assert.assertTrue(vodDeleteVideoListResponse);
if (vodDeleteVideoListResponse) {
log.debug("测试批量删除视频成功");
}
} 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、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
请求入参描述
返回对象描述
true为批量删除成功,false为批量删除失败