主页文档代码示例API 参考公告模型发行说明常见问题GitHub视频
开发者中心API 状态支持
文档
开发者中心API 状态支持

商品信息 API 常见问题

Frequently asked questions about Listings APIs.

为什么商品显示为受限/无法添加?

点击此处可展开答案。

如果您无权访问该商品类型,则商品将显示为受限商品。如果您遇到访问问题,请联系您的供应商经理或通过联系我们与我们联系,请务必说明您的问题是 API 查询。

我能否通过 API 编辑我的成本价?

点击此处可展开答案。

无法通过 API 提高现有商品的价格。价格的显著下跌也需要得到证实。在这种情况下,请联系您的供应商经理或打开 联系我们 案例。然后,通过以下方式上传您的费用变更 Items > Edit Item Costs

供应商提交的原始值不再被接受。我们怎样才能成功提交?

点击此处可展开答案。

在某些边缘情况下,架构可能已更改,供应商提交的原始值不再有效。如果是这种情况,请供应商向亚马逊支持团队提交案例。

我要如何更新高级 A+ 内容?

点击此处可展开答案。

不支持高级 A+ 内容。

为什么我的编辑即使显示为成功,却无法进入详情页面?

点击此处可展开答案。

这些 API 提供了向亚马逊发送目录数据的替代方法。无论采用何种提交方式,下游流程和管理目录数据的规则都是一样的。在某些情况下,尤其是在我们已经有商品信息的情况下,供应商提交的信息可能没有优先权。

为什么我的商品信息获取 API 响应中没有摘要信息?

点击此处可展开答案。

摘要视图是您创建商品信息所依据的 ASIN 的摘要。如果未填充摘要视图,则是因为提交失败且与 ASIN 不匹配。请务必检查您的商品类型的架构和格式,然后重试。如果问题仍然无法拒绝,请提交开发者支持案例

我顺利提交了我的商品信息,但我找不到列出的内容。

点击此处可展开答案。

您的商品信息在提交后可能遇到了问题(异步问题)。要查看此类问题,请使用 getListingsItem 操作

“与您的商品类别不匹配”问题消息是什么意思?

点击此处可展开答案。

如果您收到“与您的商品分类不匹配”消息,则表示该 ASIN 设置在供应商无权访问的商品类别中。通过 Vendor Central 提交联系我们案例,并注明消息、ASIN 和正确的商品类型。如果您需要技术支持或故障排除指南中的相关指导,请提交开发者支持案例。

“不支持 - 无法添加以下产品”问题消息是什么意思?

点击此处可展开答案。

如果您收到“不支持 - 无法添加以下商品”消息,请通过 Vendor Central 提交联系我们案例,并注明问题消息和受影响的 ASIN/外部编号。如果您需要技术支持或故障排除指南中的相关指导,请提交开发者支持案例。

产品架构

如何确定在亚马逊上架新商品的清单要求?

点击此处可展开答案。

要确定相应的清单要求,您必须首先选择正确的商品类型。这将允许亚马逊预先提供所有必要的清单要求。以下步骤概述了该过程:

  1. 使用 searchDefinitionsProductTypes 操作以获取适用于您的销售合作伙伴的产品类型列表。如果您有商品名称,则可以通过传递获得该产品类型的高度可信度推荐 itemName 参数。随着 itemName 参数,您可以组合产品标题和描述,以获得更精细的产品类型建议。你也可以使用 keywords 搜索产品类型或传递空参数以返回可用产品类型的完整列表。有关其他信息,请参阅 产品类型定义 API v2020-09-01 用例指南

  2. 知道产品类型后,请致电 getDefinitionsProductType 使用 requirements 参数来检索创建新清单的要求。

当产品类型 JSON 架构发生变化时,架构版本会更新吗?

点击此处可展开答案。

是的。架构版本始终更新为最新版本的亚马逊产品类型定义。

有多种方法可以识别两个架构版本之间的变化:

亚马逊目录要求多久更改一次?

点击此处可展开答案。

根据客户搜索和购买信号,亚马逊定期审查产品属性,并计划在每月最后一周进行必要的更新。有时,亚马逊会在计划发布之前进行一些更新,以解决客户反馈并解决任何缺陷或差距。大多数更改都是微小的,不会影响客户行为。在更新提交的清单的任何属性之前,使用 产品类型定义 API 获取最新的 JSON 架构。

我该如何使用 $lifecycle 工作流程中产品类型定义元数据中的属性?

点击此处可展开答案。

使用 $lifecycle 属性可查找有关已弃用内容和要采取的操作的详细信息。弃用内容是指在技术上仍然有效但将来会被删除的内容。例如, enumDeprecated 的元素 $lifecycle 属性列出了过时的枚举值,您应该努力将其替换为最新值。

清单提交

以编程方式在亚马逊上发布商品有哪些不同的方式?

点击此处可展开答案。

您可以通过以下方式在亚马逊上发布商品:

有关更多信息,请参阅 建筑物清单管理工作流程指南

目录商品 API v2022-04-01 和清单商品 API v2021-08-01 有什么区别?

点击此处可展开答案。

这个 目录项目 API v2022-04-01 提供 ASIN 级别的信息,这些信息是根据该商品的各种清单进行核对的。这个 清单项目 API v2021-08-01 提供有关卖家合作伙伴提交的特定清单的信息。

目录商品 API v2022-04-01 退货的数据会因商城而异吗?

点击此处可展开答案。

是的。这个 目录项目 API v2022-04-01 返回与 ASIN 相关的数据。ASIN 在每个商城中代表相同的实物商品,少数例外情况除外。但是,每个 ASIN 的数据因商城而异,因为各国对该商城有不同的数据要求。

此外,由于大多数属性是本地化文本,因此文本可能会因商城或地区而异,即使文本描述的是相同的产品。使用 marketplaceIds 过滤在 产品类型定义 API v2020-09-01 操作以获取创建或更新产品的商城特定要求。

是否可以使用 “商品清单 API v2021-08-01” 在亚马逊上创建没有 ASIN 或商品编码(UPC、GTIN 或 EAN)的商品?

点击此处可展开答案。

是的。如果您没有产品标识符,则可以创建具有 GTIN 豁免的产品。要获得豁免,您必须通过您的卖家平台账户提交手动豁免申请。有关更多信息,请参阅 卖家中心。获得批准后,您可以通过以下方式创建商品信息提交 清单项目 API v2021-08-01。你必须提供 GENERIC 作为品牌名称并设置 supplier_declared_has_product_identifier_exemption 归因于 true

如果我打电话 patchListingsItem 我打电话之后 JSON_LISTINGS_FEED,JSON 提要更新会覆盖补丁调用吗?

点击此处可展开答案。

No. Amazon uses submission timestamps to ensure that updates happen in the correct order.

When you upload a JSON_LISTINGS_FEED with inventory updates, Amazon records the feed submission time as the timestamp for all updates within the feed. If you then initiate an inventory update through the patchListingsItem operation, the system assigns the request submission time as the timestamp for that inventory update. In this scenario, if the patchListingsItem operation gets processed first, then it overrides the data provided in the JSON_LISTINGS_FEED.

我可以提交一个吗 JSON_LISTINGS_FEED 有多个市场?

点击此处可展开答案。

没有。这个 JSON_LISTINGS_FEED清单项目 API v2021-08-01 每个 Feed 支持单一商城。

谁在覆盖亚马逊商品详情页面信息方面拥有最高优先权?

点击此处可展开答案。

品牌所有者在更新亚马逊商品详情页面上的数据的优先级最高。如果亚马逊在商品详情页面上使用自己的数据,则品牌所有者可以通过向卖家平台支持部门提交通知单来改写这些数据。

在进行生产调用之前,如何验证我的清单数据?

点击此处可展开答案。

Before you submit a listing, verify that the attributes of the listing adhere to the JSON schema for the product type. For information about JSON schema validation utilities, refer to Amazon Product Type Definitions Meta-Schema (v1).
After you validate the JSON, you can preview errors before you create or update a listing by using VALIDATION_PREVIEW mode. This mode provides a test environment that checks the values that you provide in the payload for validation errors. VALIDATION_PREVIEW mode synchronously performs the same checks that are done on production submissions, but without persisting to your catalog.

我什么时候能知道我的清单是否存在问题?

点击此处可展开答案。

亚马逊对销售合作伙伴提交的清单进行多次验证。其中一些验证结果是同步返回的,以响应提交的内容。如果您将清单数据上传到 清单项目 API v2021-08-01 并且提交状态为 ACCEPTED,然后提交通过了同步验证。亚马逊向下游发送提交的内容以创建或更新 SKU。然后执行许多下游流程来创建或更新亚马逊目录中的商品。这些下游进程中的任何一个都可能生成异步返回的问题。例如,如果提交的清单包含与亚马逊目录中的其他商品冲突的数据。要在亚马逊目录中成功创建或更新商品,您必须同步和异步处理报告的问题。有关清单问题的更多信息,请参阅 处理清单商品问题清单商品 API 问题疑难解答

如何确认我的商品已在亚马逊目录中创建?

点击此处可展开答案。

亚马逊发送了一个 LISTINGS_ITEM_STATUS_CHANGE 当清单商品的状态发生变化时发出通知。当某件商品的可购买性发生变化时,或者在创建或删除清单商品时,系统会发布通知。要在创建清单时收到通知,请订阅 LISTINGS_ITEM_STATUS_CHANGE 通知。这个 ListingsItemStatus 负载中返回的属性包含与受影响清单商品相关的当前状态。如果没有价值,则状态状态不适用于上架的商品。例如,如果 DISCOVERABLE 不存在,亚马逊零售无法搜索上架的商品。

为什么在清单项目的更改反映在清单中之间会有明显的延迟 getListingItem 操作结果与何时对比 LISTINGS_ITEM_ISSUES_CHANGELISTINGS_ITEM_STATUS_CHANGE SQS 队列中会收到通知吗?

点击此处可展开答案。

There can be a delay because the Amazon backend updates every 15 minutes. As a result, every update might be delayed by 0-15 minutes depending on when the update occurred in that window.
For example, a 15-20 minute delay for the LISTINGS_ITEM_ISSUES_CHANGE and LISTINGS_ITEM_STATUS_CHANGE notifications is normal. Our data sources can be up to 15 minutes behind because the data sources rely on many upstream processes to send updates for notifications.

相比之下, getListingItem 操作直接查询当前状态,这就是为什么可以更快(在 1-5 分钟内)获得结果的原因。为了最大限度地减少限制错误,亚马逊建议您使用推送通知来接收状态变更和清单问题的实时更新。

提交产品后,为什么会因为缺少不属于产品类型 JSON 架构的属性而收到错误?

点击此处可展开答案。

在商品信息提交的整个流程阶段,亚马逊会对商品信息进行评估。如果商品信息与所选产品类型不符,则商品信息的产品类型将切换为亚马逊推荐的产品类型。这会导致新产品类型的属性显示为缺失。我们会通过针对商品信息的提醒来传达有关变更产品类型的信息。

亚马逊建议您使用 searchDefinitionsProductTypes 操作以检索所有适用产品类型的列表。要通过此操作检索正确商品类型的高置信度建议,请使用 itemName 参数。

如果我达到速率限制该怎么办 JSON_LISTINGS_FEED

点击此处可展开答案。

随着 JSON_LISTINGS_FEED,您每 5 分钟可以在单个请求中发送多达 10,000 个 SKU。为防止出现节流问题,与其发送小订阅源,不如发送一个大型 Feed。每隔几秒钟上传多个小型 Feed 效率低下,可能会导致积压。这可能会阻止其他上传数据的处理,并迫使您取消先前提交的部分上传数据。与其发送相同的数据,只发送更新的信息以减少呼叫次数。有关如何优化上传数据提交的信息,请参阅 Feeds API 最佳实践

为什么我的图片更新是在全球范围内应用的?

点击此处可展开答案。

提供的图像属性 清单项目 API v2021-08-01 即使您指定 ASIN 所在的全球层面,操作系统也会将图片映射到 ASIN marketplace_id 选择器。这种行为与其他体验一致,例如 添加一个产品 在卖家平台中。


此页面对您有帮助吗?