常见错误

下面列出了最常见的错误：

notFound：未找到商品。
not_inserted：无法插入商品。
[link] validation/invalid_value for <destinations>：网址不属于您的网站。
quota/too_many_items：已超出商家配额。

以下是按字母顺序排列的错误列表。

auth/account_access_denied

`User cannot access account <account_number>`
摘要	请求的目标是经过身份验证的用户无权访问的帐号。
常见原因	目标商家 ID 错误或者忘记在 Merchant Center 中注册用户。
处理建议	查看目标帐号是否正确或者在 Merchant Center 中将自己注册为帐号的用户（设置 > 用户）。
预防建议	无
`User is not an administrator of account <account_number>`
摘要	发出了修改帐号的请求，但是经过身份验证的用户并没有要修改的帐号的管理权限。
常见原因	无
处理建议	为经过身份验证的用户设置管理员权限。
预防建议	无

conflict

`[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

`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`）。
常见原因	在 `GET` 或 `DELETE` 请求中指定了优惠 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`）。
预防建议	无

not_inserted

`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`
摘要	对于给定的服务方法，您每天发出请求的数量超过了允许的数量。
常见原因	请参阅已发布内容限制中列出的每日配额。如果超过这些阈值，您将会收到此错误。
处理建议	在可能的情况下，将多个更改合并到一个请求中，从而减少每天发出的请求总数。请考虑在适当的时间段内对商品进行批量更改，以避免多次快速更改商品。对于在您的网站上可以表示为微数据的商品更新，请考虑使用此方法限制对 `Products` 或 `Inventory` 服务调用的数量。如果您仍然需要增加每天调用给定方法的次数，请联系我们，告知我们您的 Merchant Center ID、达到配额限制上限的方法、推算您每天需要调用这些方法的次数以及原因，我们将帮助您提高配额。
预防建议	参见上文。
`too_many_failed_auths: Too many failed authentications.`
摘要	对于您无权访问的帐号，您发出的批处理请求次数过多。
常见原因	批量请求对应的子帐号已删除或新创建的子帐号尚且不可以使用。
处理建议	避免执行会影响已删除子帐号的调用。对于新的子帐号，请等待几分钟，然后再执行会影响它的调用。
预防建议	参见上文。

required

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

userRateLimitExceeded

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

validation (V2)

`[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` 和一个款式属性的多个值（color [颜色]、size [尺寸]、pattern [图案] 或 material [材质]）。
常见原因	指定商品组 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 声明的网站相符。
预防建议	无