常见错误
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
以下是最常见的错误:
以下是按字母顺序排列的错误列表。
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 。 |
常见原因 | 在 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 更新在线商品的价格和库存状况,但在网址中指定的商店 ID 不是特殊值 online 。 |
常见原因 | 不适用 |
处理建议 | 在请求网址中将商店 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. |
---|
摘要 | 由于其他错误,无法插入商品,因为它会覆盖现有的商品条目。 |
常见原因 | 不适用 |
处理建议 | 请检查同一调用的其他错误,并解决这些问题,然后再尝试重新插入新的商品信息。 |
预防建议 | 不适用 |
配额
too_many_items: Merchant
quota exceeded |
---|
摘要 | 上传到 Google 购物的商品过多。 |
常见原因 | 如果未替换现有的有效商品,则未通过验证的商品可能仍会插入。请考虑对 Productstatuses.list 使用
includeInvalidInsertedItems 标志,以确保您的帐号没有过多的无效商品。 |
处理建议 | 如上所述,检查并移除过多的无效商品。此外,请在上传商品时指定
下架日期。到达到期日后,系统会自动删除此商品。请注意,默认的最长失效日期为商品插入或更新后的 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. |
---|
摘要 | 您针对自己无权访问的账号发出的批处理请求过多。 |
常见原因 | 针对已删除的子账号或新创建的子账号批量发出请求。 |
处理建议 | 请避免执行会影响已删除的子账号的调用。 |
预防建议 | 请参阅建议的处理提示。 |
request_too_large |
---|
摘要 | 每个批量请求发送的 entries 过多,或超过了 custombatch 请求大小限制。 |
常见原因 | 每个 custombatch 请求最多可以包含 10,000 个 entries ,压缩后的传输大小上限为 32Mb。 |
处理建议 | 请将该批次拆分为多个低于限制的批次,然后重试。 |
预防建议 | 我们建议每批发送的条目不要超过 1,000 个。 |
必填
[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
[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 声明的网站一致。 |
预防建议 | 不适用 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-07-03。
[{
"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":"其他"
}]
{
"last_modified": "最后更新时间 (UTC):2024-07-03。",
"state": ""
}