开发者专区
品类表现
发布时间：2023-09-20 最近刷新时间：2023-09-20本接口对应“政策表现”> “品类表现” >“状态总览”模块数据。
卖家中心相关界面供参考：
注：某些政策不适用于所有账号，可能没有对应的数据返回。
输入数据
资源路径
GET /gccbtapi/v1/categoryManagement/account
其它设置参见“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 |
限制日期/预计解限日期 |
|
关于状态值的说明 |
|
|
状态值 |
状态含义 |
|
1 |
正常 |
|
2 |
超标 |
|
3 |
限制预警 |
|
4 |
限制 |
|
null |
数据未更新或无数据 |
响应举例
{
"errorMessage": null,
"extension": null,
"ackValue": "SUCCESS",
"statusCode": 200,
"timeStamp": 1693467710320,
"data": {
"createPst": "2023-08-22",
"ifAppealable": "Y",
"acctStatus": 4,
"transStartDate": "2023-06-04",
"transEndDate": "2023-08-26",
"nextReviewDate": "2023-08-31",
"categories": [
{
"leafCategId": 36234,
"site": "US",
"leafName": "Sporting Goods:Golf:Golf Training Aids:Putting Greens & Aids",
"transCount": 20,
"compareWithPeer": "Very High",
"leafStatus": "BLOCK",
"qualityBbeCount": 1,
"qualityBbeRate": 0.003,
"ifAppealable": "N",
"statusUpdateDate": "2023-08-31 or later"
},
{
"leafCategId": 222,
"site": "UK",
"leafName": "22 Sporting Goods:Golf:Golf Training Aids:Putting Greens & Aids",
"transCount": 20,
"compareWithPeer": "Very High",
"leafStatus": "BLOCK",
"qualityBbeCount": 2,
"qualityBbeRate": 0.002,
"ifAppealable": "Y",
"statusUpdateDate": "2023-08-31 or later"
}
]
}
}
