如何通过eBay开发者API获取商品分类的完整路径ID？

问题背景 #

此前依赖Shopping API的GetCategoryInfo接口获取叶子分类的完整路径，但该接口已被弃用。改用Trading API的GetCategories接口后，发现实际仅返回直接父分类ID，并非文档描述的从根节点到当前节点的全量父ID（例如示例中Level 3的叶子分类，仅返回Level 2的父ID，缺失Level 1的根父ID）。

可行解决方案 #

方案1：递归调用GetCategories接口 #

通过循环递归的方式，每次用当前分类的CategoryParentID调用接口，直到获取到根分类（根分类的CategoryParentID通常为0），最后将所有分类的ID/名称按根→叶子的顺序拼接，得到完整路径。

流程示例：

• 首次调用：传入目标叶子分类ID（如示例中的169291），得到直接父ID 260010
• 二次调用：传入260010，获取其对应的父ID
• 循环调用：直到获取到根分类ID（如0）
• 拼接路径：将根分类→父分类→目标叶子分类的名称/ID串联成完整路径

方案2：拉取全量分类数据，本地构建路径映射 #

若需频繁查询分类路径，建议一次性调用GetCategories拉取目标站点的全量分类数据（需设置DetailLevel为ReturnAll，并指定SiteID），在本地构建「分类ID→父ID/名称」的映射表。后续查询时直接通过本地表递归查找父节点，直到根节点，快速生成完整路径。

注意：全量分类数据体积较大，需配合缓存机制，可通过接口返回的CategoryVersion判断是否需要更新本地数据。

调用GetCategories的关键参数 #

• SiteID：指定目标eBay站点（如美国站为0，英国站为3）
• DetailLevel：设置为ReturnAll，确保返回完整分类属性
• CategoryID：查询单个分类时传入该ID；拉取全量时可不传或传0

递归调用伪代码示例 #

def get_full_category_path(category_id, site_id):
    path = []
    current_id = category_id
    while current_id != "0":
        # 调用GetCategories接口的逻辑
        response = call_ebay_get_categories(current_id, site_id)
        category = response["CategoryArray"]["Category"][0]
        # 从头部插入，保证路径顺序是根到叶子
        path.insert(0, {"id": category["CategoryID"], "name": category["CategoryName"]})
        current_id = category["CategoryParentID"]
    return path

内容的提问来源于stack exchange，提问作者levente.nas