このページでは、Merchant API に関するデベロッパーの既知の懸念事項について説明します。
商品と在庫の insert メソッドのスループットに関する問題
報告日: 2026 年 1 月 28 日（UTC）| 最終更新日: 2026 年 3 月 31 日（UTC）
Merchant API に大量のデータを送信する際に、スループットに関するクライアントサイドのパフォーマンスの問題が発生しているという報告が寄せられています。この問題は、次のメソッドにクライアント ライブラリを使用している場合に発生することがあります。
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
さまざまなバックエンド システムのパフォーマンスを向上させるための改善を行いました。この問題が解決しない場合は、スループットを最大化するためにチャネルプールを構成する必要があります。これにより、複数の基盤となる接続を管理することで、単一の gRPC チャネルの一般的な 100 ストリームの上限を回避できます。詳細については、同時リクエスト用にコードをリファクタリングする: チャネルプールを使用してスループットを向上させるをご覧ください。
特殊文字を含む商品 ID
報告日: 2025 年 10 月 3 日（UTC）| 最終更新日: 2026 年 4 月 8 日（UTC）
productId または offerId が商品 ID の形式に関するガイドラインに準拠していない商品を管理する際に、問題が発生することがあります。このような商品 ID には、特殊文字（特にスラッシュ（/）、コロン（:）、チルダ（~）、パーセント記号（%））が含まれている場合があります。Merchant Center などのサーフェスでは、商品 ID に一部の特殊文字を使用できます。
Merchant API は、URL の一部として商品 ID をリソース name に直接組み込むため（例: accounts/{account}/products/{productId}）、これらの文字が標準の URL ルーティングと解析を妨げ、GET、PATCH、DELETE オペレーション中に予期しない 404 Not Found エラーまたは 400 Bad Request エラーが発生する可能性があります。
これらの文字を含むプロダクトを安全に操作するには、リソース名の productId セグメントまたは offerId セグメントをエンコードする必要があります。エンコード アルゴリズムは、パディングなしの Base64URL エンコードです。詳細については、accounts.productInputs.name をご覧ください。
解決済み: Merchant API エコシステム全体で動作を標準化するソリューションをリリースしました。API レスポンスに新しいフィールド base64_encoded_name が追加されました。このフィールドには、事前にエンコードされたリソース名が格納されます。これにより、手動でエンコードすることなく、リストまたは get 呼び出しの出力を後続の更新の入力として直接使用できます。
データソース作成後の遅延
報告日: 2024 年 4 月 10 日（UTC） | 最終更新日: 2024 年 5 月 12 日（UTC）
新しい DataSource の作成直後に商品、プロモーション、レビューを挿入しようとすると、既知の遅延が発生していました。データソースの作成から 5 分以内にアイテムを挿入しようとしたときに、Data source not found エラーが返されました。
解決済み: この遅延は解消され、新しく作成されたデータソースをより迅速に操作できるようになりました。
その他の問題に関しては、
その他の問題については、Merchant API のサポートを受けるページとフィードバックを送信するページをご覧ください。