最も一般的なエラーは次のとおりです。
notFound
: アイテムが見つかりません。not_inserted
: アイテムを挿入できませんでした。[link] validation/invalid_value for <destinations>
: URL がウェブサイトに属していません。- quota/too_many_items: 販売者の割り当てを超過しました。
以下に、エラーをアルファベット順に示します。
auth/account_access_denied
User cannot access account
<account_number> |
|
---|---|
概要 | 認証されたユーザーがアクセス権のないアカウントをターゲットにしたリクエストを発行しました。 |
一般的な原因 | 対象の販売者 ID にエラーがあるか、Merchant Center にユーザーを登録し忘れました。 |
推奨される対処方法 | 正しいアカウントを対象としていることを確認するか、Merchant Center([設定] > [ユーザー])でアカウントのユーザーとして登録します。 |
感染予防のヒント | NA |
User is not an administrator of
account <account_number> |
|
概要 | 認証されたユーザーが管理者権限を持たないアカウントの変更リクエストを発行しました。 |
一般的な原因 | NA |
推奨される対処方法 | 認証されたユーザーの管理者権限を設定します。 |
感染予防のヒント | NA |
競合
[productId] Product ID <product
id> is already modified by another entry in the same request for merchant
<merchant> and store code <store code> |
|
---|---|
概要 | 複数の競合するオペレーションを同時に試行しました。 |
一般的な原因 | 1 つのバッチ リクエストに、同じ商品に対して競合する複数のオペレーションが含まれているか、同じ商品に対して競合する複数のオペレーションが Content API に同時に送信されました。 |
推奨される対処方法 | 予防のヒントをご覧ください。 |
感染予防のヒント | リクエストのバッチ セット内の特定のプロダクトの 1 つのオペレーションに対するすべての変更を含めます。同じ販売者と店舗コードに対して Content API を複数回同時に呼び出さないようにするか、それらの呼び出しに重複する商品が含まれないようにしてください。 |
internalError
Internal error |
|
---|---|
概要 | Google バックエンドに問題があります。 |
一般的な原因 | NA |
推奨される対処方法 | リクエストを再試行してください。それでも失敗する場合は、フォーラムで報告してください。 |
感染予防のヒント | NA |
無効
Invalid channel:
'<channel>' |
|
---|---|
概要 | 商品 ID の一部として指定されたチャネルが無効です。
(例: not_a_channel:en:US:sku123 )。 |
一般的な原因 | NA |
推奨される対処方法 | NA |
感染予防のヒント | アイテム ID が channel:languageCode:countryCode:offerId の形式であることを確認します(例: online:en:US:sku123 )。詳細については、
Products.insert のリファレンス ドキュメントをご覧ください。 |
[countrycode] Invalid country code:
'<country_code>' |
|
概要 | 商品 ID の一部として指定された国コードが無効です。
(例: online:en:not_a_country_code:sku123 )。 |
一般的な原因 | NA |
推奨される対処方法 | NA |
感染予防のヒント | 商品 ID が channel:languageCode:countryCode:offerId の形式であることと、国コードが有効な
ISO 3166 国コードであることを確認してください。 |
[item id] Invalid item
id: '<id>' |
|
概要 | アイテム ID が無効です。例:online:en:US:sku123 ではなく sku123 。 |
一般的な原因 | GET または DELETE リクエストで、商品 ID の代わりに商品 ID を指定する。 |
推奨される対処方法 | NA |
感染予防のヒント | アイテム ID は channel:languageCode:countryCode:offerId の形式にしてください。 |
[name] The term '<term>' is not
allowed |
|
概要 | 名前に禁止用語が含まれています。 |
一般的な原因 | NA |
推奨される対処方法 | 許可された名前を使用してください。 詳しくは、フィード仕様に関するヘルプセンター記事をご覧ください。 |
感染予防のヒント | NA |
[price.currency] Please use a currency
that is supported in the target country |
|
概要 | 対象国では利用できない通貨を指定した。 |
一般的な原因 | NA |
推奨される対処方法 | 通貨と国を正しく指定してください。詳しくは、フィード仕様に関するヘルプセンター記事の price に関するセクションをご覧ください。 |
感染予防のヒント | NA |
[storeCode] storeCode must be
'online' |
|
概要 | 在庫フィードを介してオンライン商品の価格と在庫状況を更新しようとしましたが、URL で、特別な値 online 以外の値を指定しました。 |
一般的な原因 | NA |
推奨される対処方法 | リクエスト URL 内のストア ID を online に変更します。 |
感染予防のヒント | すべての在庫クエリで、オンライン商品には online を指定し、ローカル商品の店舗 ID を指定してください。 |
[<attribute>] |
|
概要 | 角かっこで囲まれている項目が無効です。 |
一般的な原因 | NA |
推奨される対処方法 | 問題のあるアイテムの仕様を修正します。詳しくは、フィード仕様に関するヘルプセンター記事をご覧ください。 |
感染予防のヒント | NA |
notFound
Item not found |
|
---|---|
概要 | 取得、更新、または削除しようとしたアイテムは存在しません。 |
一般的な原因 | 存在しないプロダクトを削除しようとしたか、削除する URL にプロダクト ID を正しく指定していない。 |
推奨される対処方法 |
Products.list を使用して商品のリストを取得し、そこに表示されているアイテムの取得、更新、削除のみを試みます。アイテム ID は channel:languageCode:countryCode:offerId の形式で指定してください(例: 277104-ekb のような特典 ID ではなく、online:ru:RU:277104-ekb )。 |
感染予防のヒント | NA |
not_inserted
The item could not be
inserted. |
|
---|---|
概要 | 他のエラーが発生したため、既存の正常なエントリが上書きされるため、商品を挿入できませんでした。 |
一般的な原因 | NA |
推奨される対処方法 | 新しい商品情報を再挿入する前に、同じ呼び出しの他のエラーを確認して対処してください。 |
感染予防のヒント | NA |
quota
too_many_items: Merchant
quota exceeded |
|
---|---|
概要 | Google ショッピングにアップロードしたアイテムが多すぎます。 |
一般的な原因 | 検証で不合格だった商品は、既存の有効な商品を置き換えなければ挿入される可能性があります。Productstatuses.list に対して
includeInvalidInsertedItems フラグを使用して、無効な商品がアカウント内に過剰な数を超えないようにすることを検討してください。 |
推奨される対処方法 | 上記の無効な商品が多すぎないかチェックし、削除します。また、商品をアップロードする場合は 有効期限を指定します。有効期限に達すると、商品は自動的に削除されます。デフォルトかつ最長の有効期限は、商品の挿入または更新から 30 日後です。 注: マルチクライアント アカウントの商品アイテム割り当ては、すべてのサブアカウントの商品の総数と照合されます。サブアカウントでこのエラーが表示された場合は、サブアカウントと MCA の両方に十分なプロダクト割り当てがあることを確認してください。 上記の解決策を試しても Merchant Center アカウントの新商品の空き容量が不足している場合は、 アカウントで追加の商品アイテムを送信する機能をリクエストできます。 |
感染予防のヒント | 推奨される対応のヒントをご覧ください。 |
too_many_subaccounts:
Maximum number of subaccounts reached |
|
概要 | マルチクライアント アカウントでサブアカウントの数が上限に達しています。 |
一般的な原因 | NA |
推奨される対処方法 | 使われていないサブアカウントを削除してください。 すべてのアカウントが有効な場合は、 MCA に追加のサブアカウントを作成する機能をリクエストできます。 |
感染予防のヒント | NA |
request_rate_too_high:
Request rate too high. Please reduce your throughput |
|
概要 | リクエストの送信が早すぎるため、リクエストの頻度を減らしてください。 |
一般的な原因 | 公開されている上限に記載されている 1 分あたりの割り当てをご覧ください。これらのしきい値を超えると、このエラーが発生します。トラフィックが急増したり、サーバーがより多くのスレッドに拡張したりすることがあります。 |
推奨される対処方法 | 1 分あたりに送信される合計リクエスト数を減らします。 |
感染予防のヒント | このエラーが発生した場合は、プログラムによるバックオフ戦略を使用して、リクエスト レートを適切なサステナブルなレベルまで下げてください。 |
daily_limit_exceeded:
merchant quota exceeded |
|
概要 | 指定されたサービス メソッドで、1 日あたりのリクエスト数が許容数を超えています。 |
一般的な原因 | 公開されている上限に記載されている 1 日あたりの割り当てをご覧ください。これらのしきい値を超えると、このエラーが発生します。 |
推奨される対処方法 | 可能であれば、複数の変更を 1 つのリクエストにまとめることで、1 日あたりの送信リクエスト数の合計を減らします。商品を何度も頻繁に変更することを避けるため、適切な期間で商品の変更をバッチ処理することを検討してください。商品アイテムの更新をウェブサイトで microdata として表現できる場合は、この方法を使用して 特定のメソッドの 1 日あたりの呼び出し回数を増やす必要がある場合は、お問い合わせのうえ、割り当て上限に達しているメソッド、それらのメソッドの 1 日あたりの呼び出し回数の推定、およびその理由を Merchant Center ID までお知らせください。割り当ての引き上げに向けてサポートいたします。 |
感染予防のヒント | 推奨される対応のヒントをご覧ください。 |
too_many_failed_auths:
Too many failed authentications. |
|
概要 | アクセス権のないアカウントに対して送信しているバッチ リクエストが多すぎます。 |
一般的な原因 | 削除されたサブアカウント、または新しく作成されたサブアカウントが使用可能になる前に、リクエストを一括で行う。 |
推奨される対処方法 | 削除されたサブアカウントに影響する呼び出しは行わないでください。 |
感染予防のヒント | 推奨される対応のヒントをご覧ください。 |
request_too_large |
|
概要 | 1 回のバッチ リクエストに送信する entries の数が多すぎるか、custombatch リクエストのサイズの上限を超えています。 |
一般的な原因 | custombatch リクエストあたり最大 10,000 個の entries を含めることができます。圧縮転送サイズの上限は 32 MB です。 |
推奨される対処方法 | 上限を下回る複数のバッチにバッチを分割してから、もう一度お試しください。 |
感染予防のヒント | バッチごとに 1,000 個以下のエントリを送信することをおすすめします。 |
required
[price.value] Required parameter: price.value |
|
---|---|
概要 | 値なしの価格が指定されています。(例: { "value": 123, "currency": "USD" } ではなく { "currency": "USD" } )。 |
一般的な原因 | NA |
推奨される対処方法 | パラメータ(
price )が正しい形式であることを確認してください。たとえば、price には value と currency の 2 つの必須フィールドがあります。 |
感染予防のヒント | NA |
[product] INSERT request must specify
product |
|
概要 | "method": "insert" を含むエントリを含むが商品を含まないカスタム バッチ リクエストを API に送信しました。 |
一般的な原因 | メソッドを get または delete に変更し忘れる。 |
推奨される対処方法 | 挿入する商品を product フィールドで指定します。 |
感染予防のヒント | メソッド
insert のバッチエントリで商品を指定し、get
メソッドまたは
delete メソッドのバッチエントリで商品 ID が指定されていることを確認してください。 |
[productId] DELETE request must specify
productId |
|
概要 | "method": "delete" を含むエントリを含むが商品 ID がないエントリを含むカスタム バッチ リクエストを API に送信しました。 |
一般的な原因 | メソッドを insert に変更し忘れる。 |
推奨される対処方法 | productID フィールドに、削除する商品を指定します。 |
感染予防のヒント | メソッド
insert のバッチエントリで商品を指定し、get
メソッドまたは
delete メソッドのバッチエントリで商品 ID が指定されていることを確認してください。 |
userRateLimitExceeded
User Rate Limit
Exceeded |
|
---|---|
概要 | リクエストの送信が早すぎるため、リクエストの頻度を減らしてください。 |
一般的な原因 | 公開されている上限に記載されている HTTP リクエストの上限をご覧ください。これらのしきい値を超えると、このエラーが発生します。トラフィックが急増したり、サーバーがより多くのスレッドに拡張したりすることがあります。 |
推奨される対処方法 | 1 分あたりに送信される合計リクエスト数を減らします。同じサービスに対する複数のメソッド呼び出しを 1 つの custombatch リクエストにまとめることで、HTTP リクエストの数を減らせます。 |
感染予防のヒント | このエラーが発生した場合は、バッチ処理とプログラマティックなバックオフ戦略を使用して、リクエスト率を適切な持続可能なレベルまで下げてください。 |
排除できます。
[adwords_redirect] |
|
---|---|
概要 | adwords_redirect フィールドが有効な URL ではない商品を登録しました。 |
一般的な原因 | NA |
推奨される対処方法 |
adwords_redirect フィールドの値が有効な URL であることを確認します。 |
感染予防のヒント | NA |
[item] auth/frontend/not_claimed |
|
概要 | 販売者のウェブサイトの URL が Merchant Center で申請されていません。 |
一般的な原因 | NA |
推奨される対処方法 | Merchant Center で URL の申請を行います。詳しい手順については、ヘルプセンターをご覧ください。 |
感染予防のヒント | NA |
[energy_efficiency_class]
validation/feed |
|
概要 | 同じ商品に energyEfficiencyClass と
単価の両方を指定しました。 |
一般的な原因 | NA |
推奨される対処方法 | 省エネ性能または単価の両方を指定するのではなく、両方を指定してください。 |
感染予防のヒント | NA |
[item] internal |
|
概要 | 内部エラーです。 |
一般的な原因 | NA |
推奨される対処方法 | リクエストを再試行してください。それでも解決しない場合は、 フォーラムで報告してください。 |
感染予防のヒント | NA |
[item_group_id] invalid_attribute |
|
概要 | itemGroupId と、バリエーション属性(色、サイズ、柄、素材)に多数の値がある商品アイテムを登録しました。 |
一般的な原因 | 商品グループ ID を指定する際に、1 つの商品に複数のサイズを指定する。 |
推奨される対処方法 | 特定のバリエーション属性(
size など)の値ごとに別々の商品を登録します。 |
感染予防のヒント | NA |
[additional_image_link]
invalid_attribute |
|
概要 | 10 個を超える追加の商品画像リンクを登録しました。 |
一般的な原因 | NA |
推奨される対処方法 | 追加の商品画像リンクの数は 10 個以内にしてください。 |
感染予防のヒント | NA |
[<attribute>] invalid_character |
|
概要 | ブランド、商品説明、その他の属性を、指定されたリクエスト エンコードで解析されない文字列として登録しました。 |
一般的な原因 | NA |
推奨される対処方法 | メッセージを確認して問題の原因となっている属性を特定し、対応する値のテキスト エンコードを検証してから再送信してください。API は有効な UTF-8 文字のみを受け入れます。 |
感染予防のヒント | NA |
[<attribute>] invalid_value |
|
概要 | 無効な色、商品説明、その他の属性が登録されています。 |
一般的な原因 | NA |
推奨される対処方法 | すべての属性がフィード仕様に準拠していることを確認します。詳しくは、フィード仕様に関するヘルプセンター記事をご覧ください。GTIN または MPN に関する問題については、 固有商品 ID に関するヘルプセンター記事をご覧ください。 |
感染予防のヒント | NA |
[<attribute>]
missing_recommended / missing_required |
|
概要 | 必須/推奨属性を指定せずに商品を登録しました。 |
一般的な原因 | NA |
推奨される対処方法 | 商品の推奨属性と必須属性をすべて含めるようにしてください。詳しくは、フィード仕様に関するヘルプセンター記事をご覧ください。 |
感染予防のヒント | NA |
[link] validation/invalid_value for
<destinations>: URLs do not belong to your website |
|
概要 | Merchant Center アカウントで申請されている URL とは異なるベース URL の商品を登録しました。 |
一般的な原因 | NA |
推奨される対処方法 | 登録した商品の URL が、Merchant Center で申請されているウェブサイトと一致していることを確認してください。 |
感染予防のヒント | NA |