已知问题

本页面记录了开发者在使用 Merchant API 时遇到的已知问题。

UnauthenticatedException 随机错误

报告时间： 2026-03-30 世界协调时间 (UTC)

多位客户在上传商品和访问其他 Merchant Center API 时遇到间歇性 UnauthenticatedException 错误。 即使重试，错误也会随机发生，并且会影响初始调用和后续尝试。有些连接失败，而另一些连接则在短时间内成功。

目前还没有解决方法或建议。

商品和库存方法出现延迟时间延长、DEADLINE_EXCEEDED 和 INTERNAL_ERROR 消息的问题

报告时间： 2026-03-18 世界协调时间 (UTC) | 解决时间： 2026-03-31 世界协调时间 (UTC)

部分用户在使用 productInputs 和 regionalInventories 方法时，遇到了持续延迟以及频繁出现 DEADLINE_EXCEEDED 或 INTERNAL_ERROR 消息的问题。主要原因是后端级别事件影响了处理效率。

解决方案： 此事件已于 2026 年 3 月 31 日完全缓解。缓解后，错误率显著降低。如果您仍然遇到高延迟问题，建议您验证客户端超时并减少请求批次大小。

商品和库存 insert 方法出现吞吐量问题

报告时间： 2026-01-28 世界协调时间 (UTC) | 上次更新时间： 2026-03-31 世界协调时间 (UTC)

我们收到了有关在向 Merchant API 传输大量数据时，客户端性能出现吞吐量问题的报告。使用以下方法的客户端库时，您可能会看到此问题：

我们已进行改进，以提高各种后端系统的性能。 如果您仍然遇到此问题，可能需要配置通道池以最大限度地提高吞吐量。这可以通过管理多个底层连接来绕过单个 gRPC 通道的典型 100 个流的限制。如需了解详情，请参阅 重构代码以处理并发请求：使用通道池提高吞吐量。

包含特殊字符的商品标识码

报告时间： 2025-10-03 世界协调时间 (UTC) | 上次更新时间： 2026-04-08 世界协调时间 (UTC)

如果 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，用于提供预编码的资源名称，这样您就可以直接将列表或 get 调用的输出用作后续更新的输入，而无需执行手动编码。

创建数据源后出现延迟

报告时间： 2024-04-10 世界协调时间 (UTC) | 上次更新时间： 2024-05-12 世界协调时间 (UTC)

在创建新的 DataSource 后立即尝试插入商品、促销活动或评价时，出现了已知延迟。如果在创建数据源后的 5 分钟内尝试插入商品，系统会返回 Data source not found 错误。

已解决： 此延迟已消除，现在可以更及时地与新创建的数据源互动。

还有其他问题吗？

如有其他问题，请访问我们的 Merchant API 帮助 和 提供反馈 页面。