文档中心 > API类目 > 多媒体平台API

taobao.picture.category.add (新增图片分类信息)

同一卖家最多添加500个图片分类,图片分类名称长度最大为20个字符

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
picture_category_name String 必须 abcdefg 图片分类名称,最大长度20字符,中文字符算2个字符,不能为空
parent_id Number 可选 0
  • 默认值:0
  • 图片分类的父分类,一级分类的parent_id为0,二级分类的则为其父分类的picture_category_id

    响应参数

    名称 类型 示例值 描述
    picture_category PictureCategory 123 图片分类信息
    • └ picture_category_id
    • Number
    • 1234
    • 图片分类ID
    • └ picture_category_name
    • String
    • 名称
    • 图片分类名
    • └ position
    • Number
    • 1
    • 图片分类排序
    • └ type
    • String
    • sys-fixture
    • 图片分类型别,sys-fixture代表店铺装修分类(系统分类),sys-auction代表宝贝图片分类(系统分类),user-define代表用户自定义分类
    • └ total
    • Number
    • 100
    • 分类下的图片数
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 图片类目的创建时间
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 图片分类的修改时间
    • └ parent_id
    • Number
    • 0
    • 一级分类的parent_id为0 二级分类的则为其父分类的picture_category_id

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    PictureCategoryAddRequest req = new PictureCategoryAddRequest();
    req.setPictureCategoryName("abcdefg");
    req.setParentId(0L);
    PictureCategoryAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <picture_category_add_response>
        <picture_category>
            <picture_category_id>1234</picture_category_id>
            <picture_category_name>名称</picture_category_name>
            <position>1</position>
            <type>sys-fixture</type>
            <total>100</total>
            <created>2000-01-01 00:00:00</created>
            <modified>2000-01-01 00:00:00</modified>
            <parent_id>0</parent_id>
        </picture_category>
    </picture_category_add_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部