eBay大中华区API开发者平台 开发者专区

搜 索

品类表现

发布时间: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点后刷新结果)
PENDING: 申诉审核中
APPROVAL:申诉已通过
REJECT: 申诉未通过

关于状态值的说明


状态值

状态含义

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"

    }

}