このページでは、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 年 5 月 13 日（UTC）
productInputs メソッドと regionalInventories
メソッドを使用しているときに、遅延が継続し、DEADLINE_EXCEEDED メッセージまたは INTERNAL_ERROR
メッセージが頻繁に表示されるという報告が一部のユーザーから寄せられています。主な原因は、処理効率に影響するバックエンド
レベルのインシデントであることが判明しました。この問題の解決に向けた取り組みは現在も進行中です。
遅延が続く場合は、リクエストのバッチサイズを小さくすることをおすすめします。前述のエラー メッセージが表示される場合は、クライアントサイドのタイムアウトを長くしてみてください。
商品と在庫の 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 ルーティングと解析を妨げ、予期しない 404 Not Found または
400 Bad Request エラーが GET、PATCH、DELETE オペレーション中に発生する可能性があります。
これらの文字を含む商品を安全に操作するには、リソース名の 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 エラーが返されました。
解決済み: この遅延は解消され、新しく作成されたデータソースをより迅速に操作できるようになりました。