putListingsItem

北美(North America）

PUT

https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/{sellerId}/{sku}

Listings Items 2021-08-01

为销售伙伴创建或完全更新现有列表项。

注意： 当 mode 为 VALIDATION_PREVIEW 时，此操作的速率限制为每秒一个请求。

注意： 与此操作相关的参数可能包含必须编码的特殊字符，以成功调用 API。为了在编码 URL 时避免 SKU 的错误，请参考 URL 编码。

使用计划：

速率（每秒请求）	突发
5	10

x-amzn-RateLimit-Limit 响应头返回应用于请求操作的使用计划速率限制（如果可用）。上表显示了此操作的默认速率和突发值。业务需求较高的销售伙伴可能会看到比此处所示更高的速率和突发值。有关更多信息，请参见销售伙伴 API 中的使用计划和速率限制。

请求参数

Path 参数

sellerId

string

必需

卖家合作伙伴标识符，例如商户账户或供应商代码。

sku

string

必需

一个销售伙伴提供的亚马逊列表标识符。

Query 参数

marketplaceIds

array[string]

必需

请求的以逗号分隔的亚马逊市场标识符列表。

示例值:

ATVPDKIKX0DER

includedData

array[string]

可选

包含在响应中的数据集的逗号分隔列表。默认值：issues。

枚举值:

identifiersissues

默认值:

issues

示例值:

issues

mode

enum<string>

请求的操作模式。

可选

枚举值:

VALIDATION_PREVIEW

示例值:

VALIDATION_PREVIEW

issueLocale

string

可选

用于问题本地化的区域设置。当未提供时，使用第一个市场的默认语言代码。示例：en_US、fr_CA、fr_FR。当指定区域设置中没有可用的本地化时，本地化消息默认为 en_US。

示例值:

en_US

Body 参数application/json

`putListingsItem`操作的请求体架构。

productType

string

必需

该商品的亚马逊产品类型。

requirements

enum<string>

可选

提供数据的要求名称。

枚举值:

LISTINGLISTING_PRODUCT_ONLYLISTING_OFFER_ONLY

attributes

object

必需

一个包含以属性名称为键的结构化列表项属性数据的JSON对象。

额外字段

integer | number | string | boolean

可选

示例

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items//?marketplaceIds=ATVPDKIKX0DER' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200成功

application/json

成功理解了创建或完全更新列表项目的请求。请查看响应以确定提交是否已被接受。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

包含对销售合作伙伴API的商品列表条目提交结果的响应。

sku

string

必需

一个销售伙伴提供的亚马逊列表标识符。

status

enum<string>

列表项提交的状态。

必需

枚举值:

ACCEPTEDINVALIDVALID

submissionId

string

必需

列表项目提交的唯一标识符。

issues

array[object (Issue) {6}]

可选

与列表项提交相关的列表项问题。

code

string

必需

一个识别问题类型的问题代码。

message

string

描述问题的消息。

必需

severity

enum<string>

问题的严重性。

必需

枚举值:

ERRORWARNINGINFO

attributeNames

array[string]

可选

与该问题相关的属性名称（如果适用）。

categories

array[string]

必需

问题类别列表。

可能的值：

INVALID_ATTRIBUTE - 表示列表中的无效属性。

MISSING_ATTRIBUTE - 突出显示列表中缺失的属性。

INVALID_IMAGE - 表示列表中无效的图片。

MISSING_IMAGE - 注明列表中缺少图片。

INVALID_PRICE - 涉及列表价格相关属性的问题。

MISSING_PRICE - 指出列表中缺少价格属性。

DUPLICATE - 识别可能存在重复问题的列表，例如此ASIN可能是另一个ASIN的重复。

QUALIFICATION_REQUIRED - 表示该列表需要资格相关的批准。

示例值:

["INVALID_ATTRIBUTE"]

enforcements

object (IssueEnforcements)

可选

此字段提供有关亚马逊采取的影响列表发布或状态的执法行动的信息。它还包括有关任何相关豁免的详细信息。

identifiers

array[object (ItemIdentifiersByMarketplace) {2}]

可选

与亚马逊目录中项目相关的身份属性，例如ASIN。

marketplaceId

string

可选

一个市场标识符。识别列表项的亚马逊市场。

asin

string

可选

商品列表的亚马逊标准识别号码（ASIN）。

示例

{
  "sku": "GM-ZDPI-9B4E",
  "status": "ACCEPTED",
  "submissionId": "f1dc2914-75dd-11ea-bc55-0242ac130003",
  "issues": []
}

🟠400请求有误

🟠403禁止访问

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2025-03-15 12:29:14

patchListingsItem

submitInventoryUpdate