既知の問題

このページでは、Merchant API に関するデベロッパーの既知の問題について説明します。

UnauthenticatedException 件のランダムエラー

報告日: 2026 年 3 月 30 日（UTC）

複数のユーザーが、商品をアップロードしたり、他の Merchant Center API にアクセスしたりする際に、断続的に UnauthenticatedException エラーが発生しています。エラーはランダムに発生し、再試行しても発生します。また、最初のリクエストと後続の試行の両方に影響します。一部の接続は失敗し、他の接続は短時間で成功します。

現時点では回避策や推奨事項はありません。

商品とインベントリのメソッドに対するレイテンシ、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 に大量のデータを送信する際に、クライアントサイドのパフォーマンスの問題（スループット）が発生するという報告が寄せられました。この問題は、次のメソッドのクライアント ライブラリを使用している場合に発生することがあります。

さまざまなバックエンド システムのパフォーマンスを向上させるための改善が行われました。この問題が引き続き発生する場合は、スループットを最大化するようにチャネル プールを構成する必要があります。これにより、複数の基盤となる接続を管理することで、単一の 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 エラーが返されます。

解決済み: この遅延は解消され、新しく作成されたデータソースとのやり取りがより迅速に行えるようになりました。

その他の問題に関しては、

その他の問題については、Merchant API のサポートを受けるとフィードバックを送信するの各ページをご覧ください。