Taxonomy API 应用指南_新更新

Taxonomy API 应用指南

发布时间：2022-01-27 最近刷新时间：2022-02-21

图示中Root Node A 就是这棵目录树的根节点，eBay在不同的站点都有一个目录树根节点称为Tree ID。在根节点之下展开并列的第一层目录节点Node Level 1，再是第二层目录节点Node Level 2…以此类推直到这根树枝的尾端枝叶节点Leaf Node。

一、获取不同eBay站点的Tree ID

getDefaultCategoryTreeId

https://api.ebay.com/commerce/taxonomy/v1/get_default_category_tree_id?

marketplace_id=string

marketplace_id 就是eBay市场所在的站点。

目前Taxonomy API支持21个eBay市场站点。

参考文档链接：

案例演示：获取eBay美国市场的目录树根节点ID

通过getDefaultCategoryTreeId开发人员可以把21个市场目录树根节点ID都获取到，做成映射储存在数据库表单中，而这个目录树根节点ID将在后续的一些其他调用中使用。

二、获取eBay某个市场站点的全部目录树结构

getCategoryTree

开发人员可以调用这个CALL来缓存某个市场站点的目录树。

{category_tree_id}作为参数调用，我们已经在第一步介绍过如何获取了。

案例演示：获取eBay美国市场的目录树结构

把这一段摘出来清晰地看出一个目录树分支：

0--->Collectibles--->Advertising--->Soda--->Fountain

枝叶目录ID 852的父目录ID是36；36的父目录ID是34；34的父目录ID是1；而1的父目录ID就是整个根目录0。

三、获取eBay推荐的商品目录分支

getCategorySuggestions

https://api.ebay.com/commerce/taxonomy/v1/category_tree/{category_tree_id}/get_category_suggestions?q=string

q传参的是一个字符串，即需要刊登的商品英文名称。

案例演示：刊登电脑显示器支架，eBay给出的推荐目录

可以看到eBay推荐的目录分支是

Computers/Tablets & Networking--->Monitors, Projectors & Accs--->Monitor Mounts & Stands。

对比一下网页刊登界面是完全吻合的。

四、获取某个尾端枝叶目录下需要填写的商品规格/属性

getItemAspectsForCategory

输入一个Category Id后就能获取刊登在这个尾端枝叶目录下的商品需要填写的规格/属性。

案例演示：按照 eBay推荐的目录把电脑显示器支架刊登到Monitor Mounts & Stands 目录ID：51052需要填写哪些规格/属性

五、获取某个市场站点下所有尾端枝叶目录以及关联的规格/属性总览

fetchItemAspects

这个CALL根据输入的市场站点tree ID生成一个包含整个目录以及关联的规格/属性的Gzip Json文件，开发人员需要下载并解压Gzip文件。

通过解压处理后截取其中一段来展示，可以看到目录名称和Id以及关联的规格/属性。是不是同第四步返回的内容结构很相似？前者根据输入的Category ID返回该目录的规格/属性信息，后者是返回该市场站点下所有的目录规格/属性信息。

总结：开发人员可以考虑下载这个Gzip Json文件来缓存某个市场站点下所有的目录规格/属性。当刊登某个商品时就不用每一个目录再单独查询了。

开发者专区