1.类目API 提供了标准类目,类目属性和类目属性值的查询功能
1.1API列表
taobao.itemcats.authorize.get查询商家被授权品牌列表和类目列表
taobao.itemcats.get获取后台供卖家发布商品的标准商品类目
taobao.itemcats.increment.get增量获取后台类目数据
taobao.itemprops.get获取标准商品类目属性
taobao.itempropvalues.get获取标准类目属性值
taobao.topats.itemcats.get全量获取后台类目数据
1.2数据结构列表
Feature类目属性
PropValue属性值
SellerAuthorize授权
ItemProp商品属性
Task批量异步任务结果
Subtask批量异步任务的子任务结果
Brand品牌
ItemCat商品类目结构
1.2数据结构详细
Feature
简要描述 类目属性
属性
名称 | 类型 | 是否隐私 | 示例值 | 描述 |
---|
attr_key | String | 否 | 1234 | 属性键 | attr_value | String | 否 | 2342 | 属性值 |
PropValue
简要描述 属性值
属性
名称 | 类型 | 是否隐私 | 示例值 | 描述 |
---|
modified_time | Date | 否 | 2000-01-01 00:00:00 | 修改时间(类目增量专用) | modified_type | String | 否 | add | 三种枚举类型:modify,add,delete (增量类目专用) | cid | Number | 否 | 50010538 | 类目ID | pid | Number | 否 | 1627207 | 属性 ID | prop_name | String | 否 | 颜色 | 属性名 | vid | Number | 否 | 3232483 | 属性值ID | name | String | 否 | 军绿色 | 属性值 | name_alias | String | 否 | 军绿色 | 属性值别名 | is_parent | Boolean | 否 | true | 是否为父类目属性 | status | String | 否 | normal | 状态。可选值:normal(正常),deleted(删除) | sort_order | Number | 否 | 0 | 排列序号。取值范围:大于零的整数 |
SellerAuthorize
简要描述 授权
属性
ItemProp
简要描述 商品属性
属性
名称 | 类型 | 是否隐私 | 示例值 | 描述 |
---|
is_input_prop | Boolean | 否 | true | 在is_enum_prop是true的前提下,是否是卖家可以自行输入的属性(注:如果is_enum_prop返回false,该参数统一返回false)。可选值:true(是),false(否)。对于品牌和型号属性(包括子属性):如果用户是C卖家,则可自定义属性;如果是B卖家,则不可自定义属性,而必须要授权的属性。 | type | String | 否 | enum | 属性值类型。可选值:multiCheck(枚举多选)optional(枚举单选)multiCheckText(枚举可输入多选)optionalText(枚举可输入单选)text(非枚举可输入) | modified_time | Date | 否 | 2000-01-01 00:00:00 | 属性修改时间(增量类目专用) | modified_type | String | 否 | add | 三种枚举类型:modify,add,delete(增量类目专用) | cid | Number | 否 | 16 | 类目ID | required | Boolean | 否 | true | 发布产品或商品时是否为必选属性(与must相同)。可选值:true(是),false(否) | pid | Number | 否 | 20000 | 属性 ID 例:品牌的PID=20000 | parent_pid | Number | 否 | 10000 | 上级属性ID | parent_vid | Number | 否 | 24455 | 上级属性值ID | name | String | 否 | 颜色 | 属性名 | is_key_prop | Boolean | 否 | true | 是否关键属性。可选值:true(是),false(否) | is_sale_prop | Boolean | 否 | true | 是否销售属性。可选值:true(是),false(否) | is_color_prop | Boolean | 否 | true | 是否颜色属性。可选值:true(是),false(否) | is_enum_prop | Boolean | 否 | true | 是否是可枚举属性。可选值:true(是),false(否) | is_item_prop | Boolean | 否 | true | 是否商品属性。可选值:true(是),false(否) | must | Boolean | 否 | true | 发布产品或商品时是否为必选属性。可选值:true(是),false(否) | multi | Boolean | 否 | true | 发布产品或商品时是否可以多选。可选值:true(是),false(否) | prop_values | PropValue [] | 否 | | | status | String | 否 | normal | 状态。可选值:normal(正常),deleted(删除) | sort_order | Number | 否 | 1 | 排列序号。取值范围:大于零的整排列序号。取值范围:大于零的整数 | child_template | String | 否 | SomeTemplate | 子属性的模板(卖家自行输入属性时需要用到) | is_allow_alias | Boolean | 否 | true | 是否允许别名。可选值:true(是),false(否) |
Task
简要描述 批量异步任务结果
属性
名称 | 类型 | 是否隐私 | 示例值 | 描述 |
---|
download_url | String | 否 | http://download.api.taobao.com/download?id=bacnoiewothoi | 大任务结果下载地址。当创建的认任务是大数据量的任务时,获取结果会返回此字段,同时subtasks列表会为空。 通过这个地址可以下载到结果的结构体,格式同普通任务下载的一样。 每次获取到的地址只能下载一次。下载的文件加上后缀名.zip打开。 | check_code | String | 否 | efdbe2545a01aff317f0cbaad6663c7c | 下载文件的MD5校验码,通过此校验码可以检查下载的文件是否是完整的。 | schedule | Date | 否 | 2000-01-01 00:00:00 | 定时类型任务的执行时间点 | task_id | Number | 否 | 12345 | 异步任务id。创建异步任务时返回的任务id号 | status | String | 否 | done | 异步任务处理状态。new(还未开始处理),doing(处理中),done(处理结束)。 | subtasks | Subtask [] | 否 | | 子任务处理结果,如果任务还没有处理完,返回的结果列表为空。如果任务处理完毕,返回子任务结果列表 | method | String | 否 | taobao.topats.trades.fullinfo.get | 此任务是由哪个api产生的 | created | Date | 否 | 2000-01-01 00:00:00 | 任务创建时间 |
Subtask
简要描述 批量异步任务的子任务结果
属性
名称 | 类型 | 是否隐私 | 示例值 | 描述 |
---|
sub_task_request | String | 否 | {"tid":123456,"fields":"tid,seller_nick"} | 子任务的有效请求参数,以json格式进行key:value的组合 | sub_task_result | String | 否 | {“trade”:{"tid":123456,"seller_nick":"淘宝卖家"}} | 子任务返回的结果,以json格式进行key:value组合,可以和单个api请求结果解析复用。以获取交易订单详情为例:子任务执行成功返回的结果格式为:{“trade”:{"tid":123456,"seller_nick":"淘宝卖家"}};子任务执行失败结果格式为{"sub_code":"isv.trade-not-exist","sub_msg":"交易订单不存在"} | is_success | Boolean | 否 | true | 标记子任务是否成功。为true表示子任务成功,用户可以按照正确执行的结果格式解析sub_task_result。为false表示子任务失败了,用户需要按照失败的结果格式解析sub_task_result(里面只有sub_code和sub_msg) |
Brand
简要描述 品牌
属性
名称 | 类型 | 是否隐私 | 示例值 | 描述 |
---|
vid | Number | 否 | 3709439 | 对应属性的 pid:vid 串中的vid | name | String | 否 | 测试品牌 | vid的值 | pid | Number | 否 | 20000 | 品牌的属性id | prop_name | String | 否 | 品牌 | 品牌的属性名 |
ItemCat
简要描述 商品类目结构
属性
名称 | 类型 | 是否隐私 | 示例值 | 描述 |
---|
features | Feature [] | 否 | | Feature对象列表 目前已有的属性: 若Attr_key为 udsaleprop,attr_value为1 则允许卖家在改类目新增自定义销售属性,不然为不允许 | modified_type | String | 否 | modify | 三种枚举类型:modify,add,delete(增量类目api使用) | modified_time | Date | 否 | 2000-01-01 00:00:00 | 增量类目:修改时间 | cid | Number | 否 | 50011999 | 商品所属类目ID | parent_cid | Number | 否 | 0 | 父类目ID=0时,代表的是一级的类目 | name | String | 否 | 单方精油 | 类目名称 | is_parent | Boolean | 否 | true | 该类目是否为父类目(即:该类目是否还有子类目) | status | String | 否 | normal | 状态。可选值:normal(正常),deleted(删除) | sort_order | Number | 否 | 1 | 排列序号,表示同级类目的展现次序,如数值相等则按名称次序排列。取值范围:大于零的整数 |
|
|
原文出自:IT博客吧(http://www.itblog8.cn/java/20130625193.html)