よくある間違い
このたび、Merchant API のベータ版をリリースすることになりました。Content API for Shopping の新しいバージョンであり、将来に向けたものです。
Merchant API を使用して統合を改善する方法と、今後の展開に役立てる方法については、Merchant API ベータ版の発表 をご覧ください。
最も一般的なエラーは次のとおりです。
以下に、エラーの一覧(アルファベット順)を示します。
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 の店舗 ID として特別な値 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
割り当て容量
too_many_items: Merchant
quota exceeded
まとめ Google ショッピングにアップロードした商品アイテムが多すぎます。
一般的な原因 検証に失敗した商品は、既存の有効な商品を置き換えなければ、挿入される場合があります。アカウントに無効な商品が多くなりすぎないように、
includeInvalidInsertedItems
フラグを Productstatuses.list
に使用することを検討してください。
推奨される対処方法 上記のように、無効な商品がないか、上記のように数が多くなりすぎていないか確認し、削除します。また、商品をアップロードする際に
有効期限 を指定します。有効期限に達すると、プロダクトは自動的に削除されます。デフォルトの有効期限(最長)は、商品の挿入または更新から 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 として表現できる商品アイテムの更新の場合は、この方法を使用して Products
または Inventory
サービスの呼び出し回数を制限することを検討してください。
特定のメソッドに対する 1 日の呼び出しがさらに必要な場合は、Merchant Center ID、割り当て上限に達しているメソッド、それらのメソッドで必要となる 1 日あたりの呼び出し回数の推定値とその理由を Google にお問い合わせ ください。割り当ての増加に向けてサポートいたします。
感染予防のヒント おすすめの対応方法 を参照してください。
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" }
。
一般的な原因 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
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンス により使用許諾されます。コードサンプルは Apache 2.0 ライセンス により使用許諾されます。詳しくは、Google Developers サイトのポリシー をご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-07-03 UTC。
[null,null,["最終更新日 2024-07-03 UTC。"],[[["This guide outlines common errors when using the Google Merchant API, categorized for easier understanding."],["Errors can relate to authentication, data conflicts, invalid data, missing information, or exceeding usage limits."],["Solutions include verifying user permissions, correcting product data, and adjusting request frequency."],["Refer to linked resources for detailed specifications, usage limits, and account management."],["This guide aids in troubleshooting and preventing common issues when interacting with the Google Merchant API."]]],[]]