【ITニュース解説】Content API for Shopping 410 (content_api_sunset): a practical Merchant API migration checklist
2026年10月22日に「Dev.to」が公開したITニュース「Content API for Shopping 410 (content_api_sunset): a practical Merchant API migration checklist」について初心者にもわかりやすく解説しています。
ITニュース概要
Google Content API for Shopping v2.1が廃止され、既存システムでHTTP 410エラーが発生する。新Merchant APIへの移行には、Google CloudでのAPI有効化やMerchant Center登録、API呼び出し方やデータ形式の大幅な変更が必要となる。
ITニュース解説
システムエンジニアを目指す初心者の皆さんにとって、プログラム同士が連携するための「窓口」となるAPIの変更は、システム開発や運用において避けて通れない重要なトピックである。今回解説する内容は、Googleが提供する商品情報連携のためのAPI、Content API for Shoppingの古いバージョンが廃止され、新しいMerchant APIへの移行が必要になるというニュースである。この変更は、特にオンラインストアの商品情報をGoogleのサービス(例えば、Google Merchant Center)と連携しているシステムに大きな影響を与える。
2026年9月1日以降、Google Content API for Shoppingのバージョン2.1(v2.1)を利用しているシステムで、HTTP 410というエラーコードが返ってくる現象が発生し始めている。これは、皆さんの書いたコードが突然壊れたわけではない。Googleが2026年8月18日をもって古いContent API for Shopping v2.1のサポートを終了したため、このAPIを使っているプロジェクトからのリクエストは、意図的にエラーを返すようになっているのだ。このエラーは当初、時々発生する程度だが、2027年の初頭までには、古いAPIを使ったすべてのリクエストが機能しなくなる予定だ。このような状況を「APIの廃止(deprecation)」と呼び、システムを運用し続けるためには、新しいAPIへの「移行(migration)」が不可欠となる。
このAPIの移行は、自分たちで商品情報の連携システム(スクリプト、定期的に実行されるタスク、あるいは自社開発のフィードサービスなど)を構築し、運用している開発者に特に関係がある。もし皆さんが一般的なECプラットフォームやアプリを利用している場合は、通常、そのプラットフォームやアプリの提供元がAPIの移行作業を担当してくれるため、直接的な対応は不要な場合が多い。
まず、エラーが発生した際の認識が重要だ。APIからの応答には、プログラムが処理の結果を伝えるための「ステータスコード」が含まれる。今回の場合、HTTP 410というステータスコードが返ってくる。これは「Gone(なくなった)」という意味で、リクエストしたリソースが永久に利用できなくなったことを示す。エラーメッセージの具体的な内容としては、JSON形式のデータの中に "code": 410 とあり、さらにエラーの原因を示す "reason": "content_api_sunset" という記述が見られるはずだ。この content_api_sunset というのは、Content APIが「日の入り(sunset)」、つまり廃止されたことを意味するGoogle固有のエラーコードである。
ここで注意すべき点が二つある。一つは、このエラーに対して単にリクエストを「リトライ」(再試行)しても解決にはならないということだ。エラーはGoogleが意図的に発生させているものであり、時間とともに発生頻度が高まり、最終的には全ての古いAPIリクエストが失敗するようになる。もう一つは、多くのシステムが、HTTPステータスコードが200番台(成功を示す)以外の場合でも、エラーを詳細に記録せずに処理を進めてしまうことがあるという点だ。その結果、Google Merchant Centerに登録されている商品情報が密かに古くなり、問題に気づかないままビジネスに悪影響を与える可能性がある。そのため、この content_api_sunset という具体的なエラー理由を、システムのログに明示的に記録するよう、プログラムを修正することが強く推奨される。
新しいMerchant APIへ移行するためには、いくつかの準備と設定が必要になる。まず、Google Cloudプロジェクト(Googleの各種サービスを利用するための基盤)において、「Merchant API」を有効にする必要がある。これは、APIを利用するための許可を得るようなものだ。次に、皆さんのGoogle Merchant Centerアカウント(オンラインストアの商品情報を管理するためのGoogleのサービス)と、Google Cloudプロジェクトを連携させる作業が必要となる。具体的には、developerRegistration:registerGcp というAPI呼び出しを使って、プロジェクトを一度登録する。この登録を忘れると、「GCPプロジェクトが登録されていない」という理由で401(認証されていない)エラーが発生してしまうので注意が必要だ。登録後、実際に連携が機能するまで数分かかる場合がある。さらに、新しいAPIでは商品情報を入力するための「API入力データソース」というものを設定する必要がある。productInputs.insert というAPIを呼び出す際には、dataSource というパラメータでどのデータソースを使うかを指定しなければならない。これは、どの「入り口」から商品情報を送るかを明確にするようなイメージだ。すでに存在する商品情報を異なるデータソースから挿入しようとすると、その商品の所有権が新しいデータソースに移転してしまうため、既存のデータソースとの整合性に注意が必要だ。認証に関しては、OAuth 2.0(ユーザーの同意を得て安全にサービスにアクセスする仕組み)か、Merchant Centerアカウントに対して管理者権限を持つサービスアカウント(サーバーサイドのプログラムがAPIにアクセスするための特別なアカウント)を使用することになる。
そして最も重要なのが、実際にAPIを呼び出す部分のコード変更だ。古いContent API v2.1と新しいMerchant APIでは、APIの呼び出し名やパラメータの構造が大きく異なる。例えば、商品情報を追加するAPIは、v2.1では products.insert だったが、Merchant APIでは productInputs.insert に変更された。この新しいAPIでは、前述の dataSource パラメータが必須となり、商品の詳細な属性情報(色、サイズなど)は productAttributes という新しい構造の下にまとめる必要がある。商品を削除するAPIも products.delete から productInputs.delete に変わり、これも dataSource が必要となる。また、v2.1にあった products.custombatch のような、複数のAPIリクエストを一度にまとめて処理する機能は、Merchant APIには直接的な代替がない。そのため、複数のリクエストを並行して実行するか、HTTPのマルチパートバッチ(一つのリクエストで複数のデータを送信する形式)を使い、最大2,000件のリクエストをまとめて処理する形に変更する必要がある。商品ステータス(例えば、在庫状況)の取得方法も変わり、v2.1の productstatuses.* のような専用APIはなくなり、Merchant APIの products.get や products.list で取得した情報に含まれる productStatus の中から確認することになる。データフィードの取得を指示する datafeeds.fetchnow も dataSources.fetch に変更される。
これらの変更以外にも、気づきにくいがシステムに問題を引き起こしやすい変更点がいくつかある。例えば、商品を一意に識別するための「商品ID」のフォーマットが大きく変更される。v2.1では channel:contentLanguage:targetCountry:offerId のような形式だったが、Merchant APIでは accounts/{account}/products/{contentLanguage~feedLabel~offerId} のような形式になる。ここでの変更点は、channel というセグメントがなくなり、区切り文字がコロン(:)からチルダ(~)に変わること、さらにスラッシュ(/)やコロン(:)のような特殊文字を含むIDは、base64url という形式でエンコード(特定の規則に基づいて別の文字セットに変換)する必要がある点だ。価格の表現方法も異なる。v2.1では {"value": "33.45", "currency": "USD"} のように通貨コードと小数点の値で指定していたが、Merchant APIでは {"amountMicros": "33450000", "currencyCode": "USD"} のように、金額をマイクロ単位(例えば、1ドルを1,000,000マイクロドルとする)で整数値として表現する形に変わる。また、商品が販売される国を示す targetCountry という項目は feedLabel に変更され、在庫状況を表す IN_STOCK のような文字列だった値は、事前に定義された列挙型(enum)という形式で指定するようになる。これらの変更点の詳細は、必ずGoogleが提供する「互換性ガイド」を参照し、最新の情報に基づいて対応を進めることが重要だ。
自分のコード内に古いContent APIの呼び出しがどこにあるかを見つけるために、特定のツールが提供されている。例えば、merchant-migration-scan というPython製のシンプルなツールは、皆さんのコードリポジトリをスキャンし、googleapiclient(Python)、Google_Service_ShoppingContent(PHP)、googleapis(Node.js)、または生のREST形式で記述されたContent APIの呼び出しをリストアップしてくれる。このツールは、ネットワークに接続せず、認証情報も不要な静的テキストスキャンなので、比較的安全に利用できる。ただし、動的に構築されるAPI呼び出しを見落とす可能性や、皆さんのGoogle CloudプロジェクトにAPI拡張が適用されているかどうかは判断できないため、その出力結果はあくまで移行作業の「チェックリスト」として活用し、最終的な確認は手動で行う必要があることを理解しておこう。
このAPI移行作業は、システムを安定して運用し、オンラインストアの商品情報をGoogleのサービスと正確に連携し続けるために不可欠なプロセスだ。新しいAPIの仕様を理解し、適切な手順でコードを修正し、テストを行うことで、将来的な問題を防ぎ、ビジネスへの影響を最小限に抑えることができる。