商品 API

提供了商品以及商品相关的sku，邮费增加，修改功能

class item.Item(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

Item(商品)结构

add(num, price, aType, stuff_status, title, desc, location_state, location_city, cid, session, **kwargs)

taobao.item.add 添加一个商品

此接口用于新增一个商品 商品所属的卖家是当前会话的用户 商品的属性和sku的属性有包含的关系，商品的价格要位于sku的价格区间之中（例如，sku价格有5元、10元两种，那么商品的价格就需要大于等于5元，小于等于10元，否则新增商品会失败） 商品的类目和商品的价格、sku的价格都有一定的相关性（具体的关系要通过类目属性查询接口获得） 商品的运费承担方式和邮费设置有相关性，卖家承担运费不用设置邮费，买家承担运费需要设置邮费 当关键属性值选择了“其他”的时候，需要输入input_pids和input_str商品才能添加成功。

delete(num_iid, session)

taobao.item.delete 删除单条商品

删除单条商品

get(num_iid, fields=[], session=None)

taobao.item.get 得到单个商品信息

获取单个商品的详细信息 卖家未登录时只能获得这个商品的公开数据，卖家登录后可以获取商品的所有数据

price_update(num_iid, session, **kwargs)

taobao.item.price.update 更新商品价格

更新商品价格

quantity_update(num_iid, quantity, session, sku_id=None, outer_id=None, aType=None)

taobao.item.quantity.update 宝贝/SKU库存修改

提供按照全量或增量形式修改宝贝/SKU库存的功能

recommend_add(num_iid, session)

taobao.item.recommend.add 橱窗推荐一个商品

将当前用户指定商品设置为橱窗推荐状态 橱窗推荐需要用户有剩余橱窗位才可以顺利执行 这个Item所属卖家从传入的session中获取，需要session绑定 需要判断橱窗推荐是否已满，橱窗推荐已满停止调用橱窗推荐接口，2010年1月底开放查询剩余橱窗推荐数后可以按数量橱窗推荐商品

recommend_delete(num_iid, session)

taobao.item.recommend.delete 取消橱窗推荐一个商品

取消当前用户指定商品的橱窗推荐状态 这个Item所属卖家从传入的session中获取，需要session绑定

update(num_iid, session, **kwargs)

taobao.item.update 更新商品信息

根据传入的num_iid更新对应的商品的数据 传入的num_iid所对应的商品必须属于当前会话的用户 商品的属性和sku的属性有包含的关系，商品的价格要位于sku的价格区间之中（例如，sku价格有5元、10元两种，那么商品的价格就需要大于等于5元，小于等于10元，否则更新商品会失败） 商品的类目和商品的价格、sku的价格都有一定的相关性（具体的关系要通过类目属性查询接口获得） 当关键属性值更新为“其他”的时候，需要输入input_pids和input_str商品才能更新成功。

update_delisting(num_iid, session)

taobao.item.update.delisting 商品下架

单个商品下架 输入的num_iid必须属于当前会话用户

update_listing(num_iid, num, session)

taobao.item.update.listing 一口价商品上架

单个商品上架 输入的num_iid必须属于当前会话用户

class item.Items(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

custom_get(outer_id, session, fields=[])

taobao.items.custom.get 根据外部ID取商品

跟据卖家设定的商品外部id获取商品 这个商品对应卖家从传入的session中获取，需要session绑定

get(session, fields=[], **kwargs)

taobao.items.get 搜索商品信息

根据传入的搜索条件，获取商品列表（类似于淘宝页面上的商品搜索功能，但是只有搜索到的商品列表，不包含商品的ItemCategory列表） 只能获得商品的部分信息，商品的详细信息请通过taobao.item.get获取 如果只输入fields其他条件都不输入，系统会因为搜索条件不足而报错。 不能通过设置cid=0来查询。

inventory_get(session, fields=[], **kwargs)

taobao.items.inventory.get 得到当前会话用户库存中的商品列表

获取当前用户作为卖家的仓库中的商品列表，并能根据传入的搜索条件对仓库中的商品列表进行过滤 只能获得商品的部分信息，商品的详细信息请通过taobao.item.get获取

list_get(num_iids, fields=[], session=None)

taobao.items.list.get 批量获取商品信息

查看非公开属性时需要用户登录

onsale_get(session, fields=[], **kwargs)

taobao.items.onsale.get 获取当前会话用户出售中的商品列表

获取当前用户作为卖家的出售中的商品列表，并能根据传入的搜索条件对出售中的商品列表进行过滤 只能获得商品的部分信息，商品的详细信息请通过taobao.item.get获取

search(fields=[], **kwargs)

taobao.items.search 搜索商品信息

• 根据传入的搜索条件，获取商品列表和商品类目信息ItemCategory列表（类似于淘宝页面上的商品搜索功能，与 taobao.items.get的区别在于：这个方法得到的结果既有商品列表，又有类目信息列表）
• 商品列表里只能获得商品的部分信息，商品的详细信息请通过taobao.item.get获取
• 商品类目信息列表里只包含类目id和该类目下商品的数量
• 不能通过设置cid=0来查询

class item.Sku(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

Sku结构

add(num_iid, properties, quantity, price, session, outer_id=None, item_price=None, lang=None)

taobao.item.sku.add 添加SKU

新增一个sku到num_iid指定的商品中 传入的iid所对应的商品必须属于当前会话的用户

delete(num_iid, properties, session, item_price=None, item_num=None, lang=None)

taobao.item.sku.delete 删除SKU

删除一个sku的数据 需要删除的sku通过属性properties进行匹配查找

get(sku_id, fields=[], num_iid=None, nick=None)

taobao.item.sku.get 获取SKU

获取sku_id所对应的sku数据 sku_id对应的sku要属于传入的nick对应的卖家

price_update(num_iid, properties, session, quantity=None, price=None, outer_id=None, item_price=None, lang=None)

taobao.item.sku.price.update 更新商品SKU的价格

更新商品SKU的价格

update(num_iid, properties, session, quantity=None, price=None, outer_id=None, item_price=None, lang=None)

taobao.item.sku.update 更新SKU信息

• 更新一个sku的数据
• 需要更新的sku通过属性properties进行匹配查找
• 商品的数量和价格必须大于等于0
• sku记录会更新到指定的num_iid对应的商品中
• num_iid对应的商品必须属于当前的会话用户

class item.Skus(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

custom_get(outer_id, session, fields=[])

taobao.skus.custom.get 根据外部ID取商品SKU

跟据卖家设定的Sku的外部id获取商品，如果一个outer_id对应多个Sku会返回所有符合条件的sku 这个Sku所属卖家从传入的session中获取，需要session绑定(注：iid标签里是num_iid的值，可以用作num_iid使用)

get(num_iids, fields=[])

taobao.item.sku.get 获取SKU

获取sku_id所对应的sku数据 sku_id对应的sku要属于传入的nick对应的卖家

class item.ItemImg(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

ItemImg结构

delete(id, num_iid, session)

taobao.item.img.delete 删除商品图片

删除itemimg_id 所指定的商品图片 传入的num_iid所对应的商品必须属于当前会话的用户 itemimg_id对应的图片需要属于num_iid对应的商品

joint_img(num_iid, pic_path, session, id=None, position=None, is_major=None)

taobao.item.joint.img 商品关联子图

• 关联一张商品图片到num_iid指定的商品中
• 传入的num_iid所对应的商品必须属于当前会话的用户
• 商品图片关联在卖家身份和图片来源上的限制，卖家要是B卖家或订购了多图服务才能关联图片，并且图片要来自于卖家自己的图片空间才行
• 商品图片数量有限制。不管是上传的图片还是关联的图片，他们的总数不能超过一定限额

upload(num_iid, session, id=None, position=None, image=None, is_major=None)

taobao.item.img.upload 添加商品图片

添加一张商品图片到num_iid指定的商品中 传入的num_iid所对应的商品必须属于当前会话的用户 如果更新图片需要设置itemimg_id，且该itemimg_id的图片记录需要属于传入的num_iid对应的商品。如果新增图片则不用设置 商品图片有数量和大小上的限制，根据卖家享有的服务（如：卖家订购了多图服务等），商品图片数量限制不同。

class item.PropImg(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

商品属性图片结构

delete(id, num_iid, session)

taobao.item.propimg.delete 删除属性图片

删除propimg_id 所指定的商品属性图片 传入的num_iid所对应的商品必须属于当前会话的用户 propimg_id对应的属性图片需要属于num_iid对应的商品

joint_prop(properties, pic_path, num_iid, session, id=None, position=None)

taobao.item.joint.propimg 商品关联属性图

• 关联一张商品属性图片到num_iid指定的商品中
• 传入的num_iid所对应的商品必须属于当前会话的用户
• 图片的属性必须要是颜色的属性，这个在前台显示的时候需要和sku进行关联的
• 商品图片关联在卖家身份和图片来源上的限制，卖家要是B卖家或订购了多图服务才能关联图片，并且图片要来自于卖家自己的图片空间才行
• 商品图片数量有限制。不管是上传的图片还是关联的图片，他们的总数不能超过一定限额，最多不能超过24张（每个颜色属性都有一张）

upload(num_iid, properties, session, id=None, image=None, position=None)

taobao.item.propimg.upload 添加或修改属性图片

添加一张商品属性图片到num_iid指定的商品中 传入的num_iid所对应的商品必须属于当前会话的用户 图片的属性必须要是颜色的属性，这个在前台显示的时候需要和sku进行关联的 商品属性图片只有享有服务的卖家（如：淘宝大卖家、订购了淘宝多图服务的卖家）才能上传 商品属性图片有数量和大小上的限制，最多不能超过24张（每个颜色属性都有一张）。

class item.Video(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

商品视频关联记录

class item.ItemCategory(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

商品查询分类结果

class item.ProductPropImg(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

产品属性图片

delete(id, product_id, session)

taobao.product.propimg.delete 删除产品属性图

1.传入属性图片ID 2.传入产品ID 删除一个产品的属性图片

upload(product_id, props, image, session, id=None, position=None)

taobao.product.propimg.upload 上传单张产品属性图片，如果需要传多张，可调多次

传入产品ID 传入props,目前仅支持颜色属性.调用taobao.itemprops.get.v2取得颜色属性pid, 再用taobao.itempropvalues.get取得vid;格式:pid:vid,只能传入一个颜色pid:vid串; 传入图片内容 注意：图片最大为2M,只支持JPG,GIF,如果需要传多张，可调多次

class item.ProductImg(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

产品图片

delete(id, product_id, session)

taobao.product.img.delete 删除产品非主图

1.传入非主图ID 2.传入产品ID 删除产品非主图

upload(product_id, image, session, id=None, position=None, is_major=None)

taobao.product.img.upload 上传单张产品非主图，如果需要传多张，可调多次

1.传入产品ID 2.传入图片内容 注意：图片最大为500K,只支持JPG,GIF格式,如果需要传多张，可调多次

class item.AfterSale(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

卖家设置售后服务对象

get(session)

taobao.aftersale.get 查询用户售后服务模板

查询用户设置的售后服务模板，仅返回标题和id

class item.ItemTemplate(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

宝贝详情页面信息

class item.ItemTemplates(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

get(session)

taobao.item.templates.get 获取用户宝贝详情页模板名称

查询当前登录用户的店铺的宝贝详情页的模板名称

class item.ItemSearch(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

商品搜索

class item.Product(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

产品结构

add(cid, price, image, name, desc, major, market_time, property_alias, session, **kwargs)

taobao.product.add 上传一个产品，不包括产品非主图和属性图片

获取类目ID，必需是叶子类目ID；调用taobao.itemcats.get.v2获取 传入关键属性,结构:pid:vid;pid:vid.调用taobao.itemprops.get.v2获取pid, 调用taobao.itempropvalues.get获取vid;如果碰到用户自定义属性,请用customer_props.

get(fields=[], product_id=None, cid=None, props=None)

taobao.product.get 获取一个产品的信息

两种方式查看一个产品详细信息: 传入product_id来查询 传入cid和props来查询

update(product_id, session, **kwargs)

taobao.product.update 修改一个产品，可以修改主图，不能修改子图片

传入产品ID 可修改字段：outer_id,binds,sale_props,name,price,desc,image 注意：1.可以修改主图,不能修改子图片,主图最大500K,目前仅支持GIF,JPG 2.商城卖家产品发布24小时后不能作删除或修改操作

class item.Products(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

get(nick, fields=[], props=None, page_no=None, page_size=None)

taobao.products.get 获取产品列表

根据淘宝会员帐号搜索所有产品信息 注意：支持分页，每页最多返回100条,默认值为40,页码从1开始，默认为第一页

search(fields=[], **kwargs)

taobao.products.search 搜索产品信息

两种方式搜索所有产品信息(二种至少传一种): 传入关键字q搜索 传入cid和props搜索 返回值支持:product_id,name,pic_path,cid,props,price,tsc 当用户指定了cid并且cid为垂直市场（3C电器城、鞋城）的类目id时，默认只返回小二确认的产品。如果用户没有指定cid，或cid为普通的类目，默认返回商家确认或小二确认的产品。如果用户自定了status字段，以指定的status类型为准

---

• Index
• Module Index
• Search Page