常见错误
下面列出了最常见的错误:
以下是按字母顺序排列的错误列表。
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 声明的网站相符。 |
预防建议 | 无 |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2019-07-03 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]