全部产品

媒资分类

本篇文档提供了PHP SDK媒资分类模块相关功能的的API调用示例,包含创建分类、删除分类、修改分类、查寻分类及其子分类。

初始化客户端

使用前请先初始化客户端,请参见初始化

创建分类

调用AddCategory接口,完成创建分类功能。

接口参数和返回字段请参见AddCategory。调用示例如下:

function addCategory($client, $cateName, $parentId=-1) {
    $request = new vod\AddCategoryRequest();
    $request->setCateName($cateName); 
    $request->setParentId($parentId);
    $request->setAcceptFormat('JSON');
    return $client->getAcsResponse($request);
}

try {
    $client = initVodClient('<AccessKeyId>', '<AccessKeySecret>');
    $addRes = addCategory($client, 'Category Name');
    var_dump($addRes);
} catch (Exception $e) {
    print $e->getMessage()."\n";
}

修改分类

调用UpdateCategory接口,完成修改分类功能。

接口参数和返回字段请参见UpdateCategory。调用示例如下:

function updateCategory($client, $cateId, $cateName) {
    $request = new vod\UpdateCategoryRequest();
    $request->setCateId($cateId);
    $request->setCateName($cateName);   // 分类名称
    $request->setAcceptFormat('JSON');
    return $client->getAcsResponse($request);
}

try {
    $client = initVodClient('<AccessKeyId>', '<AccessKeySecret>');
    $updateRes = updateCategory($client, '<Category ID>', 'New Category Name');
    var_dump($updateRes);
} catch (Exception $e) {
    print $e->getMessage()."\n";
}

删除分类

调用DeleteCategory接口,完成删除分类功能。

接口参数和返回字段请参见DeleteCategory。调用示例如下:

// 删除视频分类,同时会删除其下级分类(包括二级分类和三级分类),请慎重操作
function deleteCategory($client, $cateId) {
    $request = new vod\DeleteCategoryRequest();
    $request->setCateId($cateId);
    $request->setAcceptFormat('JSON');
    return $client->getAcsResponse($request);
}

try {
    $client = initVodClient('<AccessKeyId>', '<AccessKeySecret>');
    $delRes = deleteCategory($client, '<Category ID>');
    var_dump($delRes);
} catch (Exception $e) {
    print $e->getMessage()."\n";
}

查询分类及其子分类

调用GetCategories接口,完成查询分类及其子分类功能。

接口参数和返回字段请参见GetCategories。调用示例如下:

// 获取指定的分类信息,及其子分类(即下一级分类)的列表
function getCategories($client, $cateId=-1, $pageNo=1, $pageSize=10) {
    $request = new vod\GetCategoriesRequest();
    $request->setCateId($cateId);   // 分类ID,默认为根节点分类ID即-1
    $request->setPageNo($pageNo);
    $request->setPageSize($pageSize);
    $request->setAcceptFormat('JSON');
    return $client->getAcsResponse($request);
}

try {
    $client = initVodClient('<AccessKeyId>', '<AccessKeySecret>');
    $getRes = getCategories($client, '<Category Id>');
    var_dump($getRes);
} catch (Exception $e) {
    print $e->getMessage()."\n";
}