このページでは、Merchant API に関してデベロッパーから報告されている既知の問題について説明します。
UnauthenticatedException ランダムエラー
報告日: 2026 年 3 月 30 日（UTC）| 最終更新日: 2026 年 4 月 17 日（UTC）
複数のユーザーから、商品をアップロードする際や他の Merchant Center API にアクセスする際に、断続的に
UnauthenticatedException エラーが発生するという報告が寄せられています。
エラーはランダムに発生し、再試行しても解決しません。また、初回呼び出しと後続の試行の両方に影響します。一部の接続は失敗しますが、他の接続は短時間で成功します。
軽減策がデプロイされており、恒久的な解決策の調査が進行中です。このエラーが発生した場合は、API 呼び出しを再試行することをおすすめします。
商品と在庫のメソッドでレイテンシの増加、DEADLINE_EXCEEDED、INTERNAL_ERROR メッセージが発生する
報告日: 2026 年 3 月 18 日（UTC）| 解決日: 2026 年 3 月 31 日（UTC）
productInputs メソッドと regionalInventories
メソッドを使用しているときに、レイテンシが継続的に発生し、DEADLINE_EXCEEDED メッセージまたは INTERNAL_ERROR
メッセージが頻繁に表示されるという報告が寄せられました。主な原因は、処理効率に影響するバックエンド レベルのインシデントであることが判明しました。
解決策: このインシデントは 2026 年 3 月 31 日に完全に軽減されました。軽減策の実施後、エラー率は大幅に減少しています。引き続きレイテンシが高い場合は、クライアントサイドのタイムアウトを確認し、リクエストのバッチサイズを減らすことをおすすめします。
商品と在庫の 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 では、商品 ID が URL の一部としてリソース 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 が追加されました。このフィールドには、事前にエンコードされたリソース名が指定されます。これにより、リスト呼び出しまたは取得呼び出しの出力を、手動でエンコードすることなく、後続の更新の入力として直接使用できます。
データソースの作成後の遅延
報告日: 2024 年 4 月 10 日（UTC）| 最終更新日: 2024 年 5 月 12 日（UTC）
新しい DataSource を作成した直後に商品、プロモーション、レビューを挿入しようとすると、既知の遅延が発生しました。データソースの作成後 5 分以内に商品を挿入しようとすると、Data source not found エラーが返されました。
解決済み: この遅延は解消され、新しく作成されたデータソースをより迅速に操作できるようになりました。