putListingsItem

北美(North America）

https://sellingpartnerapi-na.amazon.com

PUT

/listings/2021-08-01/items/{sellerId}/{sku}

为销售合作伙伴创建一个新的列表项或完全更新现有的列表项。

用量计划：

速率（每秒请求数）	疲劳值
5	10

当可用时，x-amzn-RateLimit-Limit 响应头返回适用于请求操作的使用计划速率限制。前面的表格显示了此操作的默认速率和疲劳值。业务需求较高的销售合作伙伴可以获得比这里显示的更高的速率和疲劳值。欲了解更多信息，请参考销售合作伙伴 API 文档中的用量计划和速率限制。

请求参数

Path 参数

Query 参数

Body 参数application/json必填

示例

{
    "productType": "string",
    "requirements": "LISTING",
    "attributes": {
        "property1": "string",
        "property2": "string"
    }
}

请求示例代码

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&includedData=issues&mode=VALIDATION_PREVIEW&issueLocale=en_US' \
--header 'Content-Type: application/json' \
--data '{
    "productType": "string",
    "requirements": "LISTING",
    "attributes": {
        "property1": "string",
        "property2": "string"
    }
}'

返回响应

🟢200成功

application/json

已成功理解创建或完全更新商品的请求。请参考响应以确定提交是否已被接受。

Headers

Bodyapplication/json

示例

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

🟠400请求有误

🟠403禁止访问

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2026-08-27 14:13:51

patchListingsItem

getListingsRestrictions