全部产品
云市场

创建分类

更新时间:2019-02-15 13:46:48

描述

创建视频分类。最多支持三级分类,每个分类最多支持100个子分类。

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值:AddCategory
CateNameString分类名称。
  • 不能超过64个字节。
  • UTF8编码。
ParentIdLong父分类ID。若不填,则默认生成一级分类,根节点分类ID为-1。

返回参数

名称类型描述
RequestId String 请求ID。
CategoryCategory 视频分类信息。

API示例

请求示例

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=AddCategory&CateName=exampleCategory&Format=JSON&<公共参数>

注意:示例中的“公共参数”参见 公共参数说明文档

返回示例

JSON格式

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "Category": {
  4. "CateId": 67788823,
  5. "CateName": "exampleCategory",
  6. "ParentId": -1,
  7. "Level": 0
  8. }
  9. }

错误码

下表列举了本接口特有的错误码。视频点播通用的错误码信息,参见 错误码表

错误代码错误信息HTTP 状态码说明
LevelExceededMaxThe level of categories exceeded maximum.400分类层级超过最大限制。
SubTotalExceededMaxThe total of sub categories exceeded maximum.400子分类个数超过最大限制。
InvalidCateId.NotFoundThe CateId not exist.404父分类ID不存在。

SDK示例

建议使用 服务端SDK 来调用API,此API各语言调用的示例代码,请参考如下: