本页记录了开发者对 Merchant API 的已知疑虑。
商品和产品目录 insert 方法的吞吐量问题
报告时间：2026 年 1 月 28 日（世界协调时间）| 最后更新时间：2026 年 3 月 31 日（世界协调时间）
我们收到报告称，在向 Merchant API 传输大量数据时，客户端吞吐量存在性能问题。使用客户端库调用以下方法时，您可能会遇到此问题：
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
我们进行了改进，以提升各种后端系统的性能。 如果您仍然遇到此问题，则可能需要配置通道池以最大限度地提高吞吐量。这会通过管理多个底层连接来绕过单个 gRPC 通道的典型 100 流限制。如需了解详情，请参阅重构代码以处理并发请求：使用通道池提高吞吐量。
商品标识码包含特殊字符
报告时间：2025 年 10 月 3 日 (UTC) | 上次更新时间：2026 年 4 月 8 日 (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 部分进行编码。编码算法是不带填充的 Base64URL 编码。如需了解详情，请参阅 accounts.productInputs.name。
已解决：我们推出了一个解决方案，以标准化整个 Merchant API 生态系统的行为。我们在 API 响应中添加了一个新字段 base64_encoded_name，用于提供预编码的资源名称，这样您就可以直接将列表或获取调用的输出用作后续更新的输入，而无需执行手动编码。
数据源创建后的延迟时间
报告时间：2024 年 4 月 10 日（世界协调时间）| 上次更新时间：2024 年 5 月 12 日（世界协调时间）
在创建新的 DataSource 后立即尝试插入商品、促销活动或评价时，会出现已知延迟。尝试在数据源创建后的 5 分钟内插入内容时，系统返回了 Data source not found 错误。
已解决：此延迟问题已消除，现在可以更即时地与新创建的数据源进行交互。
还有其他问题吗？
如有任何其他问题，请访问获取有关 Merchant API 的帮助和提供反馈页面。