Edit Basic Info of Single Video

最終更新日:2022-01-07 14:31:39

Description

Edit the basic information of a specified single video through this interface.

Request Description

Request method POST/GET
Interface Address https://api.cloudv.haplat.net/vod/videoManage/videoEdit
If token is needed The verification token is needed

Request Parameters

Parameter Type Required Remarks
videoId string Yes The id of the video to be edited
videoName string no The modified video name, up to 40 Chinese
videoDescription string no The description of the video, up to 200 Chinese
videoClassification string no Modified video sub-category. This field is only valid when categoryNames is not filled in. If there are multiple same sub-categories, the video will set all sub-categories. (It is recommended to use categoryNames)
categoryNames string no The modified video category can specify the parent category and sub category. The format is a JSON string array encoded by urlsafe base64. If you pass empty array, it means to clear the classification settings of the video. Example: The format of the json string(eyJvcGVuIjogMSwid2hpdGVCb2FyZElkIjogInh4eCJ9) before encoding is as follows:

[{“childName”:“child category1”,“parentName”:“parent category1”},{“childName”:“child category2”,“parentName”:" Parent category 2”}] :

parentName: parent category name;

childName: child category name.

publishDomain string no The adjusted publishing domain
playerId string no The adjusted player ID.

Notes: When non-mandatory fields are not passed or are empty strings, “”, this field will not be modified (except for special instructions).

Return parameter

For common request parameters, please refer to the Request Syntax.

Example

Input example

curl -X POST 
  http://api.cloudv.haplat.net/vod/videoManage/videoEdit 
  -H 'content-type: application/x-www-form-urlencoded; charset=utf-8' 
  -H "Host: api.cloudv.haplat.net" 
  <公共的头部参数>
  <自定义的头部参数>
  -d 'videoName=testVideoEdit&videoDescription=some%20desc&videoClassification=%E7%88%B1%E6%83%85%2C%E6%88%98%E4%BA%89&publishDomain=live.ovptest.haplat.net&playerId=8275B97428DC1438&videoId=9B0F7BA8BCB9D056D4C24ADDBF821D10'

Notes: For the “public parameter” in the example, please refer to Common Parameters.

Error code

The following error codes are related to interface service logic, the generic error code can be found at Return Result.

Error code Description
1301 User has no permission
1500 Video name, exceeds 100 characters
1558 Videos can not be spliced.
1575 videoIds cannot be empty
1576 videoIds cannot contain special characters
1577 Incorrect videoIds format, please use English comma to separate videos