新更新
描述
本接口对应“政策表现”> “品类表现” >“状态总览”模块数据。
卖家中心相关界面供参考:
注:某些政策不适用于所有账号,可能没有对应的数据返回。
输入数据
资源路径
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"
}
]
}
}
过往更新
- 2023-09-20品类表现
- 2023-09-20“品类表现”-问题刊登下载
- 2022-06-15eBay对接仓使用率要求相关交易下载接口(已停用)
- 2022-06-15eBay对接仓使用率要求接口(已停用)
- 2022-04-22GetItem关于EPR更新事宜