开发者专区

“品类表现”-问题刊登下载

发布时间：2023-09-20          最近刷新时间：2024-01-25

---

描述

本接口对应“政策表现”> “品类表现” >“状态总览” >“问题刊登下载” 模块数据。

卖家中心相关界面供参考：

注：某些政策不适用于所有账号，可能没有对应的数据返回。

输入数据

资源路径
GET /gccbtapi/v1/categoryManagement/listings

其它设置参见“eBay大中华卖家API简介”首页中“其他通用设置”的描述。

请求参数
无

输出
如果查询成功，将返回“品类表现”状态总览下问题刊登下载数据。
如果查询成功但data是空数组或没值，则可能是我们目前对该用户没有数据支持，请做好相关对用户的提示。

响应字段描述

输出字段	类型	出现频率	含义
ackValue	string	总是出现	SUCCESS 或 FAILURE
errorMessage	object	有时出现	如果发生异常或请求错误，就可能看到errorMessage字段。 "errorMessage": {     "error": [       {         "errorId": 1001,         "domain": "PARAMETER",         "category": "REQUEST",         "message": "Parameter dateRange is missing",         "longMessage": "Parameter dateRange is missing",         "actionToTake": "CORRECTINPUTDATA"       }     ]   }
timestamp	long	总是出现	响应的服务器时间
data	array	有时出现	请求成功，并且有数据。否则可能返回null。

字段含义

对应对象	对象字段含义
createPst	评估日期
snadListing	问题刊登
leafCategId	品类ID
transStartDate	对应交易起始时间
transEndDate	对应交易结束时间
leafStatus	品类状态  -BLOCK:分类限制  -ALERT:分类预警
leafCategName	品类名
siteName	站点
auctTitl	刊登标题
listingStatus	刊登状态
gmvUsd	GMV
transCount	总交易量
qualityBbeCount	质量相关不良交易量
qualityBbeRt	量相关不良交易比例

响应举例

{

    "errorMessage": null,

    "extension": null,

    "ackValue": "SUCCESS",

    "statusCode": 200,

    "timeStamp": 1693892117577,

    "data": [

        {

            "createPst": "2023-09-01",

            "transStartDate": "2023-06-04",

            "siteName": "US",

            "snadListing": 165807911779,

            "leafCategId": "50459",

            "transEndDate": "2023-08-26",

            "leafStatus": "ALERT",

            "leafCategName": "eBay Motors:Parts & Accessories:Car & Truck Parts & Accessories:Interior Parts & Accessories:Switches & Controls",

            "auctTitl": "PASSENGER & REAR POWER WINDOW SWITCH For 2007-2016 GMC ACADIA 1ST 3.6L",

            "listingStatus": "Ended",

            "gmvUsd": 550.47,

            "transCount": 36,

            "qualityBbeCount": 1,

            "qualityBbeRt": 0.0278

        },

        {

            "createPst": "2023-09-01",

            "transStartDate": "2023-06-04",

            "siteName": "UK",

            "snadListing": 222,

            "leafCategId": "50459",

            "transEndDate": "2023-08-26",

            "leafStatus": "ALERT",

            "leafCategName": "22eBay Motors:Parts & Accessories:Car & Truck Parts & Accessories:Interior Parts & Accessories:Switches & Controls",

            "auctTitl": "222PASSENGER & REAR POWER WINDOW SWITCH For 2007-2016 GMC ACADIA 1ST 3.6L",

            "listingStatus": "Ended",

            "gmvUsd": 220.47,

            "transCount": 36,

            "qualityBbeCount": 36,

            "qualityBbeRt": 0.0278

        }

    ]

}