patchListingsItem - Amazon Selling Partner API (SP-API)-中文

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

使用计划：

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

当可用时，x-amzn-RateLimit-Limit 响应头返回应用于请求操作的使用计划速率限制。前面的表格指示该操作的默认速率和突发值。需要更高吞吐量的销售合作伙伴可以获得比此处显示的更高速率和突发值。有关更多信息，请参阅销售合作伙伴 API 文档中的使用计划和速率限制。

请求参数

Path 参数

sellerId

string

必需

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

sku

string

必需

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

Query 参数

marketplaceIds

array[string]

必需

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

<= 1 items

示例值:

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

`patchListingsItem` 操作的请求体模式。

productType

string

必需

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

patches

array[object (PatchOperation) {3}]

必需

一个或多个JSON Patch操作，用于对列表项执行。

>= 1 items

enum<string>

必需

JSON Patch 操作的类型。支持的 JSON Patch 操作包括添加、替换和删除。有关更多信息，请参阅 JavaScript 对象表示法 (JSON) Patch。

枚举值:

addreplacedelete

path

string

必需

要修补的元素的 JSON Pointer 路径。请参阅 JavaScript 对象表示法 (JSON) Patch 以获取更多信息。

value

array [object {1}]

可选

要添加、替换或删除的JSON值。

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

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

application/json

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}]

可选

与亚马逊目录中该项目相关的标识符，例如UPC和EAN标识符。

marketplaceId

string

亚马逊市场标识符。

可选

asin

string

可选

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

示例

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

🟠400请求缺少或无效的参数，无法解析。

🟠403表示禁止访问该资源。可能的原因包括访问被拒绝、未经授权、令牌过期或签名无效。

🟠413请求大小超过了最大接受大小。

🟠415请求负载格式不受支持。

🟠429请求的频率超过了允许的范围。

🔴500发生了意外情况，导致服务器无法完成请求。

🔴503服务器的临时超载或维护。