patchListingsItem

北美(North America）

https://sellingpartnerapi-na.amazon.com

PATCH

/listings/2020-09-01/items/{sellerId}/{sku}

部分更新（补丁）销售合作伙伴的列表项。仅支持更新顶层列表项属性。不支持更新嵌套属性。

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

使用计划：

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

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

请求参数

Path 参数

Query 参数

Body 参数application/json

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://sellingpartnerapi-na.amazon.com/listings/2020-09-01/items//?marketplaceIds=ATVPDKIKX0DER' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productType": "string",
    "patches": [
        {
            "op": "add",
            "path": "string",
            "value": [
                {}
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

成功理解了 listings 项目的补丁请求。请查看响应以确定提交是否被接受。

Headers

Body

示例

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

🟠400请求有误

🟠403禁止访问

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2025-06-15 14:54:41

deleteListingsItem

putListingsItem