Content API for Shopping のメンテナンスを 2023 年 9 月 28 日の 15:00 ~ 17:00(UTC)に予定しています。この期間中は、API を使用してアカウントを変更することはできません。
一般的なエラー
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
よくあるエラーは次のとおりです。
エラーのリストをアルファベット順に示します。
auth/account_access_denied
User cannot access account
<account_number> |
---|
まとめ | 認証されたユーザーがアクセスできないアカウントをターゲットとするリクエストを発行しました。 |
一般的な原因 | 対象の販売者 ID にエラーがあるか、Merchant Center にユーザーを登録し忘れた。 |
推奨される対処方法 | 適切なアカウントをターゲットとしていることを確認するか、Merchant Center でアカウントのユーザーとして登録してください([設定] > [ユーザー])。 |
感染予防のヒント | なし |
User is not an administrator of
account <account_number> |
---|
まとめ | 認証済みのユーザーが管理者権限を持たないアカウントを変更するリクエストを発行しました。 |
一般的な原因 | なし |
推奨される対処方法 | 認証されたユーザーの管理者権限を設定します。 |
感染予防のヒント | なし |
競合
[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
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 ショッピングにアップロードした商品アイテムが多すぎます。 |
一般的な原因 | 検証で不合格だった商品であっても、既存の有効な商品に取って代わらなければ、挿入されることがあります。Productstatuses.list で includeInvalidInsertedItems フラグを使用し、アカウントに無効な商品の数が多くならないようにすることを検討してください。 |
推奨される対処方法 | 上記のように、無効な商品が多すぎるかどうかを確認して削除します。また、商品をアップロードする際に有効期限を指定してください。有効期限に達すると、商品は自動的に削除されます。デフォルトの有効期限は、商品の挿入または更新後 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 日あたりの合計リクエスト数を削減できます。商品を迅速に何度も変更しないように、商品は適切な期間内に一括でアップロードすることを検討してください。ウェブサイトでマイクロデータとして表現できるアイテムの更新については、このアプローチを使用して Products または Inventory サービスの呼び出し回数を制限することを検討してください。
特定の方法に関する 1 日あたりの呼び出し回数を増やす必要がある場合は、Google までお問い合わせください。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 個のエントリを送信することをおすすめします。 |
required
[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 リクエストの数が少なくなります。 |
感染予防のヒント | このエラーが表示された場合は、バッチとプログラマティックのバックオフ戦略を使用して、リクエスト率を適切な持続可能なレベルまで下げます。 |
validation
[adwords_redirect] |
---|
まとめ | adwords_redirect フィールドが有効な URL ではない商品を登録しました。 |
一般的な原因 | なし |
推奨される対処方法 |
adwords_redirect フィールドの値が有効であることを確認します。 |
感染予防のヒント | なし |
[item] auth/frontend/not_claimed |
---|
まとめ | 販売者のウェブサイトの URL が Merchant Center で申請されていません。 |
一般的な原因 | なし |
推奨される対処方法 | Merchant Center で URL を申請します。詳しい手順については、ヘルプセンターをご覧ください。 |
感染予防のヒント | なし |
[energy_efficiency_class]
validation/feed |
---|
まとめ | 同じ商品の energyEfficiencyClass と単価の両方を指定しました。 |
一般的な原因 | なし |
推奨される対処方法 | 省エネ性能または単価のみを指定してください。 |
感染予防のヒント | なし |
[item] internal |
---|
まとめ | 内部エラーが発生しました。 |
一般的な原因 | なし |
推奨される対処方法 | リクエストを再試行してください。それでも解決しない場合は、フォーラムで報告してください。 |
感染予防のヒント | なし |
[item_group_id] invalid_attribute |
---|
まとめ | 1 つの商品アイテムに、バリエーション属性(色、サイズ、柄、素材)に itemGroupId と多数の値の両方が指定されています。 |
一般的な原因 | 商品グループ ID を指定する際に 1 つの商品に複数のサイズを指定する。 |
推奨される対処方法 | 特定のバリエーション属性(size など)の値ごとに異なる商品を登録します。 |
感染予防のヒント | なし |
[additional_image_link]
invalid_attribute |
---|
まとめ | 10 件を超える画像リンクを送信しました。 |
一般的な原因 | なし |
推奨される対処方法 | 追加の商品画像リンクの数は 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 および関連会社の登録商標です。
最終更新日 2023-02-27 UTC。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"必要な情報がない"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"複雑すぎる / 手順が多すぎる"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"最新ではない"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻訳に関する問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"サンプル / コードに問題がある"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"その他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"わかりやすい"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"問題の解決に役立った"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"その他"
}]