新更新
描述
本接口对应“政策表现”>“待处理刊登”>“暂停销售刊登” 模块数据。
卖家中心相关界面供参考：
详细政策说明参见：https://www.ebay.cn/newcms/Home/seller_center/4?mod=view&aid=247
输入数据
|
资源路径 |
版本 |
注释 |
|
GET /gccbtapi/v1/qc/onholdlistings |
V1 |
最新版本 |
其它设置参见“eBay大中华卖家API简介”首页中“其他通用设置”的描述。
请求参数
无
输出
如果查询成功，将返回卖家onholdlistings数据。
如果查询成功但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 |
|
评估起始时间 |
reviewBegDt |
|
下线时间 |
auctEndDt |
|
物品编号 |
listingId |
|
SKU |
sku |
|
刊登标题 |
auctTitl |
|
交易额 |
gmv |
|
交易量 |
transCnt |
|
质量相关不良交易率 |
qualityBbeRate |
|
质量相关不良交易数量 |
qualityBbeCnt |
|
SNAD数量 |
snadCnt |
|
中差评数量 |
nnfbCnt |
|
描述低分数量 |
lowIadCnt |
|
长期质量相关不良交易率 |
qualityBbeRate1y |
|
长期质量相关不良交易数量 |
qualityBbeCnt1y |
|
长期总交易额 |
gmv1y |
|
长期总交易数量 |
transCnt1y |
|
最新状态： 1: 暂停销售 2: 已恢复 |
holdSts |
|
暂停开始时间 |
holdStartDt |
|
暂停结束时间 |
holdEndDt |
响应举例
{
"errorMessage": null,
"extension": null,
"ackValue": "SUCCESS",
"statusCode": 200,
"timeStamp": 1720678664790,
"data": [
{
"createPst": "2024-06-24",
"listingId": 193085727382,
"sku": "H01-1710A@#GG2008-1",
"auctTitl": "Mini Fridge Electric Cooler and Warmer 12V DC Cooler Car Refrigerator for Travel",
"gmv": 4427.99,
"transCnt": 57,
"qualityBbeRate": 0.0702,
"qualityBbeCnt": 4,
"snadCnt": 2,
"nnfbCnt": 2,
"lowIadCnt": 0,
"qualityBbeRate1y": 0.0385,
"qualityBbeCnt1y": 5,
"gmv1y": 9792.16,
"transCnt1y": 130,
"reviewBegDt": "2024-03-31",
"reviewEndDt": "2024-06-22",
"holdSts": 1,
"holdStartDt": "2024-06-29",
"holdEndDt": "2024-07-06"
}
]
}
过往更新
- 2024-07-23待处理刊登>暂停销售刊登
- 2024-07-23待处理刊登>待下线刊登
- 2024-07-19[eBay 开发者公告] GPSR相关的API更新
- 2024-04-22Transaction IDs即将到来的变化
- 2024-03-05[eBay 开发者公告] 新的 Store API 已经推出
