このページでは、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 ルーティングと解析を妨げ、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 エラーが返されました。
解決済み: この遅延は解消され、新しく作成されたデータソースをより迅速に操作できるようになりました。