add_alert
重要: Content API for Shopping は 2026 年 8 月 18 日 に廃止されます。
rocket
Content API for Shopping の正式な後継である
Merchant API をご紹介します。
update
Merchant API の新機能、バグの修正、更新に関する
最新情報を入手
してください。
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
フィードバックを送信
よくある間違い
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
最も一般的なエラーは次のとおりです。
以下はエラーの一覧(アルファベット順)です。
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 には value と currency の 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 で申し立てられたウェブサイト と一致していることを確認します。
対策のヒント なし
フィードバックを送信
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンス により使用許諾されます。コードサンプルは Apache 2.0 ライセンス により使用許諾されます。詳しくは、Google Developers サイトのポリシー をご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2026-07-06 UTC。
ご意見をお聞かせください
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2026-07-06 UTC。"],[],["The document details errors within the Merchant API, which is the future version of the Content API for Shopping. Key errors involve `notFound` (item does not exist), `not_inserted` (cannot insert due to conflicts), and `quota/too_many_items` (exceeded upload limits). Handling involves verifying product IDs, addressing conflicting entries, and managing quotas. Common causes include incorrect IDs, simultaneous conflicting operations, and exceeding item limits. Prevention focuses on formatting product IDs correctly, batching changes, reducing invalid products, and using product expiration dates. Other errors such as account access, internal issues, URL, currency, ID, and missing parameters are covered.\n"]]