patchListingsItem

北美(North America）

https://sellingpartnerapi-na.amazon.com

PATCH

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

部分更新（补丁）卖家合作伙伴的listing项目。只能对顶层的listing项目属性进行补丁，不支持嵌套属性的补丁。

用法计划：

速率（每秒请求数）	峰值
5	5

返回头x-amzn-RateLimit-Limit会返回适用于请求操作的用法计划速率限制（如果有的话）。上表显示了此操作的默认速率和峰值值。业务需求需要更高吞吐量的卖家合作伙伴可以获得比此处显示的更高的速率和峰值值。有关更多信息，请参阅卖家合作伙伴API文档中的用法计划和速率限制。

请求参数

Path 参数

Query 参数

Body 参数application/json必填

示例

{
    "productType": "string",
    "patches": [
        {
            "op": "add",
            "path": "string",
            "value": [
                {
                    "property1": "string",
                    "property2": "string"
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH '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",
    "patches": [
        {
            "op": "add",
            "path": "string",
            "value": [
                {
                    "property1": "string",
                    "property2": "string"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

已成功理解商品的 patch 请求。请参考响应以确定提交是否已被接受。

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

getListingsItem

putListingsItem