调用AddCategory创建视频分类。最大支持三级分类,每个分类最多支持创建100个子分类。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AddCategory |
系统规定参数。取值:AddCategory。 |
CateName | String | 是 | 搞笑 |
分类名称。
|
ParentId | Long | 否 | 1000126088 |
父分类ID。若不填,则默认生成一级分类,根节点分类ID为-1。 说明 因为素材分类的一级分类为内置的,不支持修改,所以当Type为material时,此字段必填。
|
Type | String | 否 | default |
分类类型。取值:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 25818875-5F78-4A*****F6-D7393642CA58 |
请求ID。 |
Category | Struct |
视频分类信息。 |
|
CateId | Long | 100200304 |
视频分类ID。 |
CateName | String | 电影 |
分类名称。
|
Level | Long | 0 |
分类层级。一级分类层级为0。 |
ParentId | Long | -1 |
父分类ID。一级分类父ID为-1。 |
Type | String | default |
分类类型。取值:
|
示例
请求示例
https://vod.aliyuncs.com/?Action=AddCategory
&CateName=搞笑
&<公共请求参数>
正常返回示例
XML
格式
<AddCategoryResponse>
<Category>
<ParentId>-1</ParentId>
<Type>default</Type>
<Level>0</Level>
<CateName>电影</CateName>
<CateId>100200304</CateId>
</Category>
<RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
</AddCategoryResponse>
JSON
格式
{
"Category": {
"ParentId": "-1",
"Type": "default",
"Level": "0",
"CateName": "电影",
"CateId": "100200304"
},
"RequestId": "25818875-5F78-4A*****F6-D7393642CA58"
}
错误码
访问错误中心查看更多错误码。
接口错误码
下表列举了本接口特有的错误码。
错误代码 |
错误信息 |
HTTP 状态码 |
说明 |
---|---|---|---|
LevelExceededMax |
The level of categories exceeded maximum. |
400 |
分类层级超过最大限制。 |
SubTotalExceededMax |
The total of sub categories exceeded maximum. |
400 |
子分类个数超过最大限制。 |
InvalidCateId.NotFound |
The CateId not exist. |
404 |
父分类ID不存在。 |
SDK示例
建议使用服务端SDK来调用API,此API各语言调用的示例代码,请参见:
在文档使用中是否遇到以下问题
更多建议
匿名提交