列表限制API v2021-08-01用例指南

亚马逊SPAPI

# 什么是列表限制API?

使用Listings Restrictions的Selling Partner API(Listings Restrictions API),您可以检查是否存在阻止在亚马逊目录中为某个商品创建listing的限制.如果某个商品被限制,您可能会采取额外的步骤来请求批准创建listing.请参阅Listings Restrictions API Reference (opens new window),了解有关API操作和相关数据类型和模式的详细信息.

将房源限制API与房源项目API结合起来使用. 例如,你可以首先使用房源限制API确定是否存在房源限制. 如果不存在限制,你就可以调用房源项目API来创建仅有offer-的房源. 请参阅房源项目API参考 (opens new window),了解关于房源项目API的更多信息.

主要特点

  • 列表限制API提供了关于列表限制的详细信息,如果有的话,在一个由ASIN.标识的现有目录项目上
  • 你可以根据条件类型选择性地过滤限制.
  • 列表限制API支持在一次调用中检查多个市场的列表限制.
  • 当需要批准时,上市限制API会返回下一步的链接,这样你就可以寻求批准来创建上市.

术语

ASIN: 亚马逊标准识别码,用于识别亚马逊目录中的物品.

清单: 亚马逊清单是销售伙伴在亚马逊上列出销售的商品,并由库存单位(SKU).包含在亚马逊清单中的产品事实被调和到亚马逊目录中的商品,由亚马逊标准识别码(ASINs)识别

限制条件限制是指阻止创建清单的条件.在某些情况下,限制是由于批准要求,在这种情况下,可能有额外的步骤来申请批准.

# Tutorial获取目录中某物品的列表限制

使用本教程来检索亚马逊目录中现有物品的任何上市限制.

先决条件

要完成本教程,你需要

*来自您为之调用的销售伙伴的授权.更多信息请参见销售伙伴API开发者指南 (opens new window)

# 步骤1 -获取亚马逊目录中某个商品的列表限制

调用getListingsRestrictions (opens new window)操作来返回任何列表限制,并传递以下参数

查询参数

Parameter 实例 Description 要求
asin B0000ASIN1 该商品的亚马逊标准识别码(ASIN).

类型: string

是的
conditionType used_very_good The condition used to filter restrictions.

Type: enum(ConditionType)

没有
sellerid AXXXXXXXXXXX 一个销售伙伴的标识符,如商家账户.

类型: string

是的
marketplaceIds ATVPDKIKX0DER Comma-delimited list of Amazon marketplace identifiers for the request.

See the Selling Partner API Developer Guide for the list of Amazon marketplace identifiers.

Type: < string > array(csv)

是的
reasonLocale en_US A locale for reason text localization.当没有提供时,将使用第一个市场的默认语言代码.例子en_US, fr_CA, fr_FR.当指定的地区没有本地化时,本地化的信息默认为en_US.

Type: string

No

示例请求

https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/restrictions
   ?asin=B08XXLG119
   &amp;conditionType=条件类型
   &amp;sellerId=AXXXXXXXXXXX
   &amp;marketplaceIds=ATVPDKIKX0DER
1
2
3
4
5

响应

一个成功的响应会返回所有适用的限制信息,如果有的话. 如果在指定的市场中没有对指定的条件类型(提供的限制),响应中的限制列表将是空的.

如果在指定的市场中对指定的条件类型(when provided)存在限制,评估响应中的reasons数组,以确定原因并确定下一步,如果有的话. 每个原因都有一个reasonCode (opens new window),说明为什么该列表被限制.

需要批准时

亚马逊要求销售伙伴在列出某些商品进行销售之前获得批准.批准过程可能包括各种批准要求和资格.如果响应中的reasonCode表明需要批准,销售伙伴可能会申请批准列出该商品.

在这种情况下,使用响应中链接数组中的信息,指示销售伙伴导航到所提供的URL链接,然后按照那里的指示申请批准上市.

一个成功的响应包括以下内容

Name Example Description
restrictions 参见响应示例 A list of restrictions for the specified Amazon catalog item.

Type: < Restriction > array

示例响应 (无限制)

{
  "限制": [
    {
    }
  ]
}
1
2
3
4
5
6

示例响应(限制条件存在)

{
  "限制": [
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "collectible_like_new",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "new_new",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你需要批准才能列出."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "used_acceptable",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "used_like_new",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "collectible_very_good",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "used_very_good",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "collectible_acceptable",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "collectible_good",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "used_good",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "refurbished_refurbished",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    }
  ]
}


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
Last Updated: 2022/10/20 下午11:58:42