よくある間違い

最も一般的なエラーは次のとおりです。

以下はエラーの一覧(アルファベット順)です。

auth/account_access_denied

User cannot access account <account_number>
概要認証されたユーザーがアクセスできないアカウントを対象とするリクエストを発行した。
一般的な原因対象の販売者 ID に誤りがあるか、Merchant Center でユーザーを登録し忘れています。
推奨される対処方法正しいアカウントをターゲットにしていることを確認するか、Merchant Center[設定] > [ユーザー])でアカウントのユーザーとして登録します。
対策のヒントなし
User is not an administrator of account <account_number>
概要認証されたユーザーに管理者権限がないアカウントの変更リクエストを発行した。
一般的な原因なし
推奨される対処方法認証済みユーザーの管理者権限を設定します。
対策のヒントなし

conflict

[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 に送信されました。
推奨される対処方法予防のヒントをご覧ください。
対策のヒント特定の商品に対するすべての変更を、バッチ処理されたリクエストのセット内の単一のオペレーションに含めます。同じ販売者と店舗コードに対して Content API を同時に複数回呼び出すことは避けるか、呼び出しに重複する商品が含まれないようにしてください。

internalError

Internal error
概要Google バックエンドに問題があります。
一般的な原因なし
推奨される対処方法リクエストを再試行してください。一貫して失敗する場合は、お問い合わせください
対策のヒントなし

無効

Invalid channel: '<channel>'
概要商品 ID の一部として無効なチャネルが指定されています。例: not_a_channel:en:US:sku123
一般的な原因なし
推奨される対処方法なし
対策のヒント商品 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
一般的な原因なし
推奨される対処方法なし
対策のヒント商品 ID が channel:languageCode:countryCode:offerId の形式であり、国コードが有効な ISO 3166 の国コードであることを確認してください。
[item id] Invalid item id: '<id>'
概要アイテム ID が無効です(online:en:US:sku123 ではなく sku123 など)。
一般的な原因GET リクエストまたは DELETE リクエストで、アイテム ID ではなく特典 ID を指定している。
推奨される対処方法なし
対策のヒント商品 ID が channel:languageCode:countryCode:offerId の形式であることを確認します。
[name] The term '<term>' is not allowed
概要名前に禁止語句が含まれています。
一般的な原因なし
推奨される対処方法使用できる名前を使用してください。詳しくは、フィード仕様に関するヘルプセンターの記事をご覧ください。
対策のヒントなし
[price.currency] Please use a currency that is supported in the target country
概要ターゲット国で利用できない通貨を指定した。
一般的な原因なし
推奨される対処方法通貨と国が正しく指定されていることを確認します。詳しくは、フィード仕様に関するヘルプセンター記事の price に関するセクションをご覧ください。
対策のヒントなし
[storeCode] storeCode must be 'online'
概要在庫フィードでオンライン商品の価格と在庫状況を更新しようとしたが、URL の店舗 ID に特殊な値 online 以外の値を指定した。
一般的な原因なし
推奨される対処方法リクエスト URL のストア ID を online に変更します。
対策のヒントすべての在庫クエリで、オンライン商品には online、ローカル商品には店舗 ID を指定してください。
[<attribute>]
概要角かっこで囲まれた項目が無効です。
一般的な原因なし
推奨される対処方法問題のある商品の仕様を修正します。詳しくは、フィード仕様に関するヘルプセンター記事をご覧ください。
対策のヒントなし

notFound

Item not found
概要取得、更新、削除しようとしたアイテムが存在しません。
一般的な原因存在しない商品を削除しようとした場合、または削除用の URL でプロダクト ID が正しく指定されていない場合。
推奨される対処方法 Products.list を使用して商品のリストを取得し、そこに表示されるアイテムの取得、更新、削除のみを試みます。商品 ID は channel:languageCode:countryCode:offerId の形式で指定してください。たとえば、277104-ekb のようなオファー ID ではなく、online:ru:RU:277104-ekb のように指定します。
対策のヒントなし

not_inserted

The item could not be inserted.
概要他のエラーにより、既存の有効なエントリが上書きされるため、商品を挿入できませんでした。
一般的な原因なし
推奨される対処方法同じ呼び出しの他のエラーを確認し、新しい商品情報を再挿入する前にそれらのエラーに対処します。
対策のヒントなし

quota

too_many_items: Merchant quota exceeded
概要Google ショッピングにアップロードされたアイテムが多すぎます。
一般的な原因検証に失敗した商品でも、既存の有効な商品を置き換えない場合は挿入できます。includeInvalidInsertedItems フラグを使用して Productstatuses.list し、アカウントに無効な商品が多すぎないようにすることを検討してください。
推奨される対処方法

上記のとおり、無効な商品が過剰に登録されていないか確認し、削除します。また、商品をアップロードする際に 有効期限を指定します。有効期限が切れると、商品は自動的に削除されます。デフォルトの有効期限と最長の有効期限は、商品の挿入または更新から 30 日後です。

: マルチクライアント アカウントの商品アイテムの割り当ては、すべてのサブアカウントの商品アイテムの合計数に対してチェックされます。サブアカウントでこのエラーが発生した場合は、サブアカウントと MCA の両方に十分な商品割り当てがあることを確認してください。

これらの解決策を試しても、Merchant Center アカウントで新しい商品を登録するスペースが不足している場合は、 アカウントで登録できるアイテム数を増やすようリクエストできます。

対策のヒント推奨される対処方法を参照してください。
too_many_subaccounts: Maximum number of subaccounts reached
概要マルチ クライアント アカウントで許可されているサブアカウントの最大数に達しています。
一般的な原因なし
推奨される対処方法

廃止されたサブアカウントを削除します。

すべてのアカウントが有効な場合は、 MCA で追加のサブアカウントを作成する権限をリクエストできます。

対策のヒントなし
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 として表すことができるアイテムの更新については、このアプローチを使用して Products サービスまたは Inventory サービスへの呼び出し数を制限することを検討してください。

特定のメソッドに対する 1 日あたりの呼び出し回数をさらに増やす必要がある場合は、Google にお問い合わせください。Merchant Center ID、割り当て上限に達しているメソッド、それらのメソッドで 1 日あたりに必要な呼び出し回数の推定値とその理由をお知らせいただければ、割り当ての引き上げについてご協力いたします。

対策のヒント推奨される対処方法を参照してください。
too_many_failed_auths: Too many failed authentications.
概要アクセス権のないアカウントに対するバッチ リクエストが多すぎます。
一般的な原因削除されたサブアカウント、または使用可能になる前に新しく作成されたサブアカウントに対して、バッチでリクエストを行っている。
推奨される対処方法削除されたサブアカウントに影響する呼び出しは避けてください。
対策のヒント推奨される対処方法を参照してください。
request_too_large
概要バッチ リクエストあたりの entries の数が多すぎるか、custombatch リクエスト サイズの上限を超えています。
一般的な原因custombatch リクエストごとに最大 10,000 個の entries を含めることができます。圧縮された転送サイズの制限は 32 MB です。
推奨される対処方法バッチを上限を下回る複数のバッチに分割してから、もう一度お試しください。
対策のヒントバッチごとに送信するエントリは 1,000 個以下にすることをおすすめします。

必須

[price.value] Required parameter: price.value
概要値のない価格を指定しました。たとえば、{ "value": 123, "currency": "USD" } ではなく { "currency": "USD" } となっている場合などです。
一般的な原因なし
推奨される対処方法パラメータ(ここでは price)が適切な形式であることを確認します。たとえば、price には valuecurrency の 2 つの必須フィールドがあります。
対策のヒントなし
[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 である商品を送信した。
一般的な原因なし
推奨される対処方法 adwords_redirect フィールドの値が有効な URL であることを確認します。
対策のヒントなし
[item] auth/frontend/not_claimed
概要販売者のウェブサイトの URL が Merchant Center で申請されていません。
一般的な原因なし
推奨される対処方法Merchant Center で URL を申請します。詳しい手順については、ヘルプセンターをご覧ください。
対策のヒントなし
[energy_efficiency_class] validation/feed
概要同じ商品に energyEfficiencyClass 単位価格の両方が指定されています。
一般的な原因なし
推奨される対処方法省エネ性能または価格の計量単位のいずれか一方のみを指定します。両方は指定できません。
対策のヒントなし
[item] internal
概要内部エラー。
一般的な原因なし
推奨される対処方法リクエストを再試行してください。一貫して失敗する場合は、お問い合わせください
対策のヒントなし
[item_group_id] invalid_attribute
概要itemGroupId とバリエーション属性(色、サイズ、柄、素材)の複数の値の両方を含む商品を登録した。
一般的な原因商品グループ ID を指定しながら、商品のサイズを複数指定している。
推奨される対処方法 size などのバリエーション属性の値ごとに異なる商品を登録します。
対策のヒントなし
[additional_image_link] invalid_attribute
概要追加の商品画像リンクを 11 個以上登録した。
一般的な原因なし
推奨される対処方法 追加の商品画像リンクの数を 10 個に制限します。
対策のヒントなし
[<attribute>] invalid_character
概要指定されたリクエスト エンコードを使用して解析されない文字列として、ブランド、説明、その他の属性を送信した。
一般的な原因なし
推奨される対処方法メッセージを確認して、どの属性が問題の原因になっているかを特定し、対応する値のテキスト エンコードを検証してから、再送信してください。API で使用できるのは、有効な UTF-8 文字のみです。
対策のヒントなし
[<attribute>] invalid_value
概要無効な色、説明、その他の属性を登録した。
一般的な原因なし
推奨される対処方法すべての属性がフィード仕様に準拠していることを確認します。詳しくは、フィード仕様に関するヘルプセンターの記事をご覧ください。GTIN または MPN の問題については、 固有商品 ID のヘルプセンター記事をご覧ください。
対策のヒントなし
[<attribute>] missing_recommended/missing_required
概要必須または推奨の属性がない商品を登録した。
一般的な原因なし
推奨される対処方法商品に推奨属性と必須属性をすべて含めてください。詳しくは、フィード仕様に関するヘルプセンター記事をご覧ください。
対策のヒントなし
[link] validation/invalid_value for <destinations>: URLs do not belong to your website
概要Merchant Center アカウントで申し立てられた URL と異なるベース URL を持つ商品を登録した。
一般的な原因なし
推奨される対処方法送信された商品の URL が、Merchant Center で申し立てられたウェブサイトと一致していることを確認します。
対策のヒントなし