开发者专区
品类表现
发布时间：2023-09-20 最近刷新时间：2024-07-09本接口对应“政策表现”> “品类表现” >“状态总览”模块数据。
卖家中心相关界面供参考：
注：某些政策不适用于所有账号，可能没有对应的数据返回。
输入数据
|
资源路径 |
版本 |
注释 |
|
GET /gccbtapi/v1/categoryManagement/account |
V1 |
|
|
GET /gccbtapi/v2/categoryManagement/account |
V2 |
最新版本 |
其它设置参见“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 |
评估日期 |
|
transStartDate |
评估开始日期 |
|
transEndDate |
评估结束日期 |
|
nextReviewDate |
下一次评估时间 |
|
acctStatus |
状态：详见"关于状态值的说明" |
|
ifAppealable |
申诉状态 N：不可申诉 Y：可申诉 |
|
categories |
品类列表信息: 以下为展开数据 |
|
- leafCategId |
品类ID |
|
- site |
|
|
- leafName |
|
|
- transCount |
|
|
- qualityBbeRate |
质量相关不良交易率 |
|
- compareWithPeer |
与同行业比 |
|
- leafStatus |
当前状态 BLOCK: 分类限制 ALERT: 分类预警 |
|
- qualityBbeCount |
质量相关不良交易量 |
|
- ifAppealable |
品类申诉状态 N=不可申诉 Y=可申诉 |
|
- statusUpdateDate |
限制日期/预计解限日期 |
|
appealStatus 新 |
申诉审核结果:
null: 没有申诉结果 （如果您已提交申诉，请周五晚9:30点后刷新结果） |
|
关于状态值的说明 |
|
|
状态值 |
状态含义 |
|
1 |
正常 |
|
2 |
超标 |
|
3 |
限制预警 |
|
4 |
限制 |
|
null |
数据未更新或无数据 |
响应举例
{
"errorMessage": null,
"extension": null,
"ackValue": "SUCCESS",
"statusCode": 200,
"timeStamp": 1718777004954,
"data": {
"createPst": "2024-06-09",
"ifAppealable": "Y",
"acctStatus": 4,
"transStartDate": "2024-02-10",
"transEndDate": "2024-04-10",
"nextReviewDate": "2024-05-01",
"categories": [
{
"leafCategId": 262137,
"site": "US",
"leafName": "eBay Motors:Parts & Accessories:Car & Truck Parts & Accessories:Engines & Engine Parts:Timing Components & Kits:Timing Kits",
"transCount": 152,
"compareWithPeer": "High",
"leafStatus": "ALERT",
"qualityBbeCount": 6,
"qualityBbeRate": 0.0395,
"ifAppealable": "N",
"statusUpdateDate": null
},
{
"leafCategId": 33646,
"site": "US",
"leafName": "eBay Motors:Parts & Accessories:Car & Truck Parts & Accessories:Exterior Parts & Accessories:Hoods:Hood Panels",
"transCount": 203,
"compareWithPeer": "Very High",
"leafStatus": "BLOCK",
"qualityBbeCount": 10,
"qualityBbeRate": 0.0493,
"ifAppealable": "Y",
"statusUpdateDate": "2024-03-06 / 2024-05-31"
},
{
"leafCategId": 33620,
"site": "US",
"leafName": "eBay Motors:Parts & Accessories:Car & Truck Parts & Accessories:Engines & Engine Parts:Engine Rebuild Kits",
"transCount": 88,
"compareWithPeer": "High",
"leafStatus": "ALERT",
"qualityBbeCount": 6,
"qualityBbeRate": 0.0682,
"ifAppealable": "N",
"statusUpdateDate": null
}
],
"appealStatus": "REJECT"
}
}
