本页记录了开发者在使用 Merchant API 时遇到的已知问题。
产品和库存的吞吐量问题 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 段进行编码。编码算法为不含填充的 Base64URL 编码。如需了解详情，请参阅 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 错误。
已解决：此延迟问题已消除，现在可以更及时地与新创建的数据源进行互动。
还有其他问题吗？
如有任何其他问题，请访问我们的获取 Merchant API 方面的帮助和提供反馈页面。