taobao.itempropvalues.get (获取标准类目属性值)

获取标准类目属性值

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String [] 必须 cid,pid,prop_name,vid,name,name_alias,status,sort_order
  • 最大列表长度:20
  • 需要返回的字段。目前支持有:cid,pid,prop_name,vid,name,name_alias,status,sort_order
    pvs String 可选 20561:1234 属性和属性值 id串,格式例如(pid1;pid2)或(pid1:vid1;pid2:vid2)或(pid1;pid2:vid2)
    cid Number 必须 50010538 叶子类目ID ,通过taobao.itemcats.get获得叶子类目ID
    type Number 可选 1
  • 默认值:1
  • 获取类目的类型:1代表集市、2代表天猫
    attr_keys String [] 可选 item_must_image
  • 最大列表长度:20
  • 属性的Key,支持多条,以“,”分隔

    响应参数

    名称 类型 示例值 描述
    last_modified String 2000-01-01 00:00:00 最近修改时间。格式:yyyy-MM-dd HH:mm:ss
    prop_values PropValue [] 属性值
    • └ cid
    • Number
    • 50010538
    • 类目ID
    • └ pid
    • Number
    • 1627207
    • 属性 ID
    • └ vid
    • Number
    • 3232483
    • 属性值ID
    • └ name
    • String
    • 军绿色
    • 属性值
    • └ prop_name
    • String
    • 颜色
    • 属性名
    • └ status
    • String
    • normal
    • 状态。可选值:normal(正常),deleted(删除)
    • └ name_alias
    • String
    • 军绿色
    • 属性值别名
    • └ is_parent
    • Boolean
    • true
    • 是否为父类目属性
    • └ sort_order
    • Number
    • 0
    • 排列序号。取值范围:大于零的整数
    • features
    • Feature []
    • 属性值feature
    • └ attr_key
    • String
    • 1234
    • 属性键
    • └ attr_value
    • String
    • 2342
    • 属性值

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ItempropvaluesGetRequest req = new ItempropvaluesGetRequest();
    req.setFields("cid,pid,prop_name,vid,name,name_alias,status,sort_order");
    req.setPvs("20561:1234");
    req.setCid(50010538L);
    req.setDatetime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setType(1L);
    req.setAttrKeys("item_must_image");
    ItempropvaluesGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <itempropvalues_get_response>
        <last_modified>2000-01-01 00:00:00</last_modified>
        <prop_values>
            <prop_value>
                <cid>50010538</cid>
                <pid>1627207</pid>
                <vid>3232483</vid>
                <name>军绿色</name>
                <prop_name>颜色</prop_name>
                <status>normal</status>
                <name_alias>军绿色</name_alias>
                <is_parent>true</is_parent>
                <sort_order>0</sort_order>
                <features>
                    <feature>
                        <attr_key>1234</attr_key>
                        <attr_value>2342</attr_value>
                    </feature>
                </features>
            </prop_value>
        </prop_values>
    </itempropvalues_get_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-parameter 参数无效,格式不对、非法值、越界等
    isp.category-service-unavailable 服务异常,请稍后重试 服务异常,请稍后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部