常见错误

以下是最常见的错误:

下面按字母顺序列出了错误。

auth/account_access_denied

User cannot access account <account_number>
总结向目标用户无权访问的帐号发出了请求。
常见原因目标商家 ID 出错,或忘记在 Merchant Center 中注册用户。
处理建议请检查您所定位的帐号是否正确,或在 Merchant Center 中注册自己帐号的用户(设置 > 用户)。
预防建议不适用
User is not an administrator of account <account_number>
总结发出了修改帐号的请求,但经过身份验证的用户并没有该帐号的管理员权限。
常见原因不适用
处理建议为经过身份验证的用户设置管理员权限。
预防建议不适用

冲突

[productId] Product ID <product id> is already modified by another entry in the same request for merchant <merchant> and store code <store code>
总结尝试同时执行多个有冲突的操作。
常见原因单个批量请求包含针对同一商品的多个冲突操作,或者向 Content API 同时提交了多个存在冲突的操作。
处理建议请参阅预防提示。
预防建议将给定商品的所有更改包含到批量请求中的单个操作中。请尽量避免同时针对同一商家和商店代码多次调用 Content API,或确保这些调用不包含重叠的商品。

internalError

Internal error
总结Google 后端存在问题。
常见原因不适用
处理建议请重试请求。 如果一直失败,请在论坛上告知我们。
预防建议不适用

无效

Invalid channel: '<channel>'
总结作为产品 ID 一部分提供的渠道无效。例如:not_a_channel:en:US:sku123
常见原因不适用
处理建议不适用
预防建议确保您的商品 ID 的格式为 channel:languageCode:countryCode:offerId,例如:online:en:US:sku123。如需了解详情,请参阅 Products.insert 的参考文档。
[countrycode] Invalid country code: '<country_code>'
总结作为商品 ID 一部分提供的国家/地区代码无效。例如:online:en:not_a_country_code:sku123
常见原因不适用
处理建议不适用
预防建议确保您的商品 ID 的格式为 channel:languageCode:countryCode:offerId,并且国家/地区代码是有效的 ISO 3166 国家/地区代码。
[item id] Invalid item id: '<id>'
总结商品 ID 无效,例如sku123,而不是 online:en:US:sku123
常见原因GETDELETE 请求中指定优惠 ID 而不是商品 ID。
处理建议不适用
预防建议确保您的商品 ID 的格式为 channel:languageCode:countryCode:offerId
[name] The term '<term>' is not allowed
总结名称包含禁用的字词。
常见原因不适用
处理建议请使用允许的名称。 如需了解详情,请参阅 Feed 规范帮助中心文章
预防建议不适用
[price.currency] Please use a currency that is supported in the target country
总结指定了目标国家/地区不支持的货币。
常见原因不适用
处理建议请确保已正确指定币种和国家/地区。如需了解详情,请参阅 Feed 规范帮助中心文章中关于 price 的部分
预防建议不适用
[storeCode] storeCode must be 'online'
总结尝试通过产品目录 Feed 更新在线商品的价格和库存状况,但指定了特殊值 online 作为网址中的商店 ID。
常见原因不适用
处理建议在请求网址中将商店 ID 更改为 online
预防建议请务必在所有商品目录查询中为在线商品指定 online,并为本地商品指定商店 ID。
[<attribute>]
总结方括号中指定的项目无效。
常见原因不适用
处理建议修复问题商品的规范。如需了解详情,请参阅 Feed 规范帮助中心文章
预防建议不适用

notFound

Item not found
总结您尝试获取、更新或删除的内容不存在。
常见原因尝试删除不存在的商品,或未在网址中正确指定要删除的商品 ID。
处理建议使用 Products.list 获取商品列表,仅尝试获取、更新或删除出现在其中的商品。请确保以 channel:languageCode:countryCode:offerId 的形式指定商品 ID,例如 online:ru:RU:277104-ekb,而不是优惠 ID,如下所示:277104-ekb
预防建议不适用

未插入

The item could not be inserted.
总结由于其他错误,无法插入商品,因为这会覆盖现有的商品条目。
常见原因不适用
处理建议检查同一调用的其他错误,并解决问题,然后尝试重新插入新产品信息。
预防建议不适用

quota

too_many_items: Merchant quota exceeded
总结上传到 Google 购物的商品过多。
常见原因如果产品不能取代现有的有效产品,则仍然可以插入未能验证的产品。请考虑使用 includeInvalidInsertedItems 标志来Productstatuses.list,以确保您的帐号中没有过多的无效商品。
处理建议

检查并移除上述过多的无效商品。此外,请在上传商品时指定失效日期。到了过期日期后,系统会自动删除商品。请注意,默认的最长到期日为商品插入或更新后的 30 天。

注意:根据所有子帐号中的商品总数来检查多客户帐号的商品配额。如果您在子帐号中看到此错误,请确保子帐号和 MCA 有足够的商品配额。

如果您尝试过这些解决方案,但 Merchant Center 帐号中的新商品仍然没有空间,那么您可以请求在您的帐号中提交更多商品

预防建议请参阅推荐的处理提示
too_many_subaccounts: Maximum number of subaccounts reached
总结您的多客户帐号所允许的子帐号数已达到上限。
常见原因不适用
处理建议

删除过时的子帐号。

如果您的所有帐号都处于有效状态,您可以申请在您的 MCA 中创建其他子帐号

预防建议不适用
request_rate_too_high: Request rate too high. Please reduce your throughput
总结请求速度过快;请降低请求频率。
常见原因请参阅已发布内容限制中列出的每分钟配额。如果超过这些阈值,您将会收到此错误。有时,流量激增会导致此错误,或者您的服务器扩展到更多线程。
处理建议减少每分钟发出的请求总数。
预防建议当您收到此错误时,请使用程序化退避策略将请求速率降低到合适的可持续水平。
daily_limit_exceeded: merchant quota exceeded
总结您针对指定的服务方法每天发出的请求数超过了允许的数量。
常见原因请参阅已发布内容限制中列出的每日配额。如果超过这些阈值,您将会收到此错误。
处理建议

尽可能将多项更改合并为一个请求,以减少每天发出的请求总数。请考虑在适当的时间段内批量更改商品,以免多次快速更改商品。对于可以在您的网站上表示为微数据的项目更新,请考虑使用该方法限制对 ProductsInventory 服务的调用次数。

如果您仍然需要对指定方法进行更多每日调用,请与我们联系并告知我们您的 Merchant Center ID、哪些方法达到了配额限制、估计每天需要调用多少次以及原因是什么,我们将与您一起提高您的配额。

预防建议请参阅推荐的处理提示
too_many_failed_auths: Too many failed authentications.
总结您针对无权访问的帐号发出了过多的批量请求。
常见原因批量针对已删除的子帐号或新创建的子帐号发出请求,使其可用。
处理建议避免进行会影响已删除的子帐号的调用。
预防建议请参阅推荐的处理提示
request_too_large
总结每个批量请求发送的 entries 过多,或超出了 custombatch 请求大小限制。
常见原因每个 custombatch 请求最多可包含 10000 个 entries,压缩传输大小上限为 32Mb。
处理建议请将该批次拆分为多个低于限制的批次,然后重试。
预防建议我们建议每批发送的条目不超过 1000 个。

必填

[price.value] Required parameter: price.value
总结指定了不含价值的价格。例如:{ "currency": "USD" },而不是 { "value": 123, "currency": "USD" }
常见原因不适用
处理建议确保参数(此处为 price)的格式正确。例如,price 有两个必填字段:valuecurrency
预防建议不适用
[product] INSERT request must specify product
总结向 API 提交了自定义批处理请求,其中包含带有 "method": "insert" 的条目,但是没有商品。
常见原因忘记将方法更改为 getdelete
处理建议通过 product 字段指定要插入的商品。
预防建议请确保使用 insert 方法的批量条目指定商品,并使用 getdelete 方法的批量条目指定商品 ID。
[productId] DELETE request must specify productId
总结向 API 提交了自定义批处理请求,其中包含带有 "method": "delete" 但无商品 ID 的条目。
常见原因忘记将方法更改为 insert
处理建议通过 productID 字段指定要删除的商品。
预防建议请确保使用 insert 方法的批量条目指定商品,并使用 getdelete 方法的批量条目指定商品 ID。

userRateLimitExceeded

User Rate Limit Exceeded
总结请求速度过快;请降低请求频率。
常见原因请参阅已发布内容限制中列出的 HTTP 请求限制。如果超过这些阈值,您将会收到此错误。有时,流量激增会导致此错误,或者您的服务器扩展到更多线程。
处理建议减少每分钟发出的请求总数。将对同一服务的多个方法调用批量处理到一个 custombatch 请求中,这样有助于减少发出的 HTTP 请求的数量。
预防建议当您收到此错误时,请使用批量和程序化退避策略将请求速率降低到合适的可持续水平。

validation

[adwords_redirect]
总结提交的商品的 adwords_redirect 字段不是有效的网址。
常见原因不适用
处理建议请确保 adwords_redirect 字段的值是有效的网址。
预防建议不适用
[item] auth/frontend/not_claimed
总结尚未在 Merchant Center 中声明商家的网站网址的所有权。
常见原因不适用
处理建议Merchant Center 中声明网址。帮助中心提供了执行此操作的详细过程。
预防建议不适用
[energy_efficiency_class] validation/feed
总结为同一商品同时指定 energyEfficiencyClass单价
常见原因不适用
处理建议只能指定能效等级或价格单位,不能同时指定这两者。
预防建议不适用
[item] internal
总结内部错误。
常见原因不适用
处理建议请重试请求。 如果一直失败,请在论坛上告知我们。
预防建议不适用
[item_group_id] invalid_attribute
总结提交的商品同时具有 itemGroupId 属性,并且为某个款式属性(颜色、尺寸、图案或材质)提供了多个值。
常见原因指定商品分组 ID 时为商品指定多个尺寸。
处理建议为指定款式/规格属性(例如 size)的每个值提交不同的商品。
预防建议不适用
[additional_image_link] invalid_attribute
总结提交了 10 个以上的图片链接。
常见原因不适用
处理建议附加图链接的数量限制为 10。
预防建议不适用
[<attribute>] invalid_character
总结以字符串形式提交品牌、说明或其他属性,该字符串不使用指定的请求编码进行解析。
常见原因不适用
处理建议查看消息以找出导致问题的属性,然后在重新提交之前验证相应值的文本编码。该 API 仅接受有效的 UTF-8 字符。
预防建议不适用
[<attribute>] invalid_value
总结提交了无效的颜色、说明或其他属性。
常见原因不适用
处理建议确保所有属性都符合 Feed 规范。如需了解详情,请参阅 Feed 规范帮助中心文章。如需了解 GTIN 或 MPN 问题,请参阅唯一商品标识码帮助中心文章
预防建议不适用
[<attribute>] missing_recommended/missing_required
总结提交的商品没有必需属性/推荐属性。
常见原因不适用
处理建议确保为商品添加所有推荐 / 必需属性。如需了解详情,请参阅 Feed 规范帮助中心文章
预防建议不适用
[link] validation/invalid_value for <destinations>: URLs do not belong to your website
总结提交商品的基准网址与 Merchant Center 帐号声明的网址不同。
常见原因不适用
处理建议确保已提交的商品的网址与 Merchant Center 声明的网站相符。
预防建议不适用