本页面记录了 Merchant API 的已知开发者问题。
UnauthenticatedException 个随机错误
报告日期：世界协调时间 (UTC) 2026-03-30 | 上次更新日期：世界协调时间 (UTC) 2026-04-17
多位客户在上传商品和访问其他 Merchant Center API 时遇到间歇性 UnauthenticatedException 错误。
即使重试，也会随机发生错误，并且会影响初始调用和后续尝试。有些连接失败，而另一些连接在短时间内成功。
我们已部署缓解措施，并正在调查永久性解决方案。如果您遇到此错误，建议您重试 API 调用。
商品和商品目录方法的延迟时间增加、DEADLINE_EXCEEDED 和 INTERNAL_ERROR 消息
报告日期：2026 年 3 月 18 日（世界协调时间）| 上次更新日期：2026 年 5 月 13 日（世界协调时间）
部分用户在使用 productInputs 和 regionalInventories 方法时，遇到了持续的延迟，并频繁收到 DEADLINE_EXCEEDED 或 INTERNAL_ERROR 消息。主要原因是后端级突发事件影响了处理效率。我们仍在努力解决此问题。
如果您仍然遇到延迟时间较长的问题，建议您减小请求批次大小。如果您收到上述错误消息，可以尝试增加客户端超时时间。
商品和商品目录 insert 方法的吞吐量问题
报告时间：2026 年 1 月 28 日（世界协调时间）| 上次更新时间：2026 年 3 月 31 日（世界协调时间）
我们收到报告称，在向 Merchant API 传输大量数据时，客户端存在吞吐量方面的性能问题。使用以下方法的客户端库时，您可能会遇到此问题：
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
我们进行了一些改进，以提升各种后端系统的性能。 如果您仍然遇到此问题，可能需要配置信道池以最大限度提高吞吐量。通过管理多个底层连接，此功能可绕过单个 gRPC 通道的典型 100 个流的限制。如需了解详情，请参阅重构代码以处理并发请求：使用通道池提高吞吐量。
包含特殊字符的商品标识码
报告日期：2025-10-03（世界协调时间）| 上次更新日期：2026-04-08（世界协调时间）
如果 productId 或 offerId 不符合商品 ID 格式设置指南，用户在管理商品时可能会遇到问题。此类商品 ID 可能包含特殊字符，最常见的是正斜杠 (/)、英文冒号 (:)、波浪号 (~) 和百分号 (%)。Merchant Center 等平台已允许在商品 ID 中使用某些特殊字符。
由于 Merchant API 将商品标识码直接纳入资源 name 作为网址的一部分（例如 accounts/{account}/products/{productId}），因此这些字符可能会干扰标准网址路由和解析，从而在 GET、PATCH 或 DELETE 操作期间导致意外的 404 Not Found 或 400 Bad Request 错误。
为了安全地与包含这些字符的产品互动，您必须对资源名称的 productId 或 offerId 部分进行编码。编码算法为不含填充的 Base64网址 编码。如需了解详情，请参阅 accounts.productInputs.name。
已解决：我们已推出解决方案，以标准化整个 Merchant API 生态系统中的行为。我们在 API 响应中添加了一个新字段 base64_encoded_name，用于提供预编码的资源名称，这样您就可以直接将 list 或 get 调用的输出用作后续更新的输入，而无需执行手动编码。
数据源创建后的延迟时间
报告时间：2024-04-10 世界协调时间 (UTC) | 上次更新时间：2024-05-12 世界协调时间 (UTC)
尝试在创建新的 DataSource 后立即插入商品、促销信息或评价时，出现了已知延迟。尝试在创建数据源后的 5 分钟内插入项时，系统返回了 Data source not found 错误。
已解决：此延迟问题已消除，现在可以更及时地与新创建的数据源进行互动。
还有其他问题吗？
如有任何其他问题，请访问我们的 Get help with Merchant API（获取 Merchant API 方面的帮助）和 Give feedback（提供反馈）页面。