プロダクトを移行する

Merchant API では、商品データをより堅牢かつ直感的に管理できます。主な変更点は、商品データが 2 つの異なるリソースに分割されたことです。ProductInput はデータの送信に使用され、Product は商品のステータスや問題など、処理済みの最終バージョンを表示するために使用されます。この新しい構造により、より予測可能で透明性の高いエクスペリエンスが提供されます。

このガイドでは、Content API for Shopping からの統合の移行に役立つ主な違いについて説明します。新機能の使用に関する詳細なガイドについては、プロダクトを管理するをご覧ください。

主な違い

Merchant API での商品管理方法と Content API for Shopping での商品管理方法の主な違いは次のとおりです。

  • 入力データと処理済みデータ専用のリソース: Merchant API では、商品管理が 2 つのリソースに分割されます。ProductInput リソースを使用して、商品データの挿入、更新、削除を行うことができます。読み取り専用の Product リソースを使用すると、Google が入力を処理し、ルールを適用して、補助ソースのデータを結合した後の最終的な商品を表示できます。

  • 商品名のエンコード: ProductInput.name フィールドと Product.name フィールドの両方に、パディングなしの base64url(RFC 4648 セクション 5)エンコードを使用できます。商品名に Merchant API で使用される文字または URL 予約文字が含まれている場合は、エンコードが必須です。たとえば、商品名に次のいずれかの文字が含まれている場合は、商品名をエンコードする必要があります。

    % . + / : ~ , ( * ! ) & ? = @ # $
    
  • 統合プロダクトのステータス: productstatuses サービスが削除されます。商品の検証に関する問題と掲載先のステータスが、productStatus フィールド内の Product リソースに直接含まれるようになり、データ取得が簡素化されました。

  • 予測可能な商品データの更新: 新しい productInputs.patch メソッドは、特定の商品入力を直接変更します。これは、Content API for Shopping と比較して大幅な改善です。Content API for Shopping では、他のフィードのアップロードによって更新が予期せず上書きされることがありました。Merchant API では、その特定の商品入力が再度更新されるか削除されるまで、更新が保持されます。商品の更新は、処理済みの Product リソースではなく、ProductInput リソースに適用されます。

  • データソースを選択してデータ マネジメントを簡素化: すべての productInputs 書き込みオペレーションで dataSource クエリ パラメータが必要になり、変更するデータソースが明示されるようになりました。これは、データを提供するソースが複数ある場合に特に便利です。

  • 新しいリソース識別子: 商品は、id フィールドではなく、RESTful リソース name で識別されるようになりました。形式は accounts/{account}/products/{product} です。

  • カスタム バッチなし: custombatch メソッドは使用できなくなりました。非同期リクエストまたは HTTP バッチ処理を使用すると、1 回の HTTP 呼び出しで複数のリクエストを送信できます。

をご覧ください。

移行中のデータソースに関するガイドライン

データソースを移行する前に、データソース戦略を選択することを強くおすすめします。

スムーズな移行を確保し、オファーの盗用などの問題を回避するには、次の推奨事項に沿って対応してください。

  • データベースをバックフィルする: すべてのアイテム オペレーションの前に dataSources.list を呼び出すのではなく、ローカル データベースの 1 回限りのバックフィルを実行することを強くおすすめします。各商品レコードに dataSource 名フィールドを追加して、リクエストで正しい ID を直接指定できるようにします。

  • 任意のラベルと言語のデータソースを統合して使用する: Merchant API を使用すると、ラベルと言語を指定せずにデータソースを作成できるため、任意のデータソース ラベルと言語で商品を挿入できます。ラベルと言語ごとに 1 つのデータソースを使用することを検討してください。

  • 商品を保護する: データソース ルールを使用する場合は、products.get を呼び出して、商品に関連付けられている正確な dataSource を確認してから、商品を更新または削除します。これにより、目的のソースを変更し、誤ってオファーを盗むことを防ぐことができます。

リクエスト

このセクションでは、Content API for Shopping と Merchant API のリクエスト形式を比較します。

リクエストの説明 Content API for Shopping Merchant API
商品を入手する GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product}
商品を一覧表示する GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products
商品を挿入する POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products POST https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs:insert
商品を更新する PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} PATCH https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput}
商品の削除 DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} DELETE https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput}
商品のステータスを取得する GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses/{productId} GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product}
商品ステータスを一覧表示する GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products
複数のリクエストをバッチ処理する POST https://shoppingcontent.googleapis.com/content/v2.1/products/custombatch 非同期リクエストまたは HTTP バッチ処理を使用する

識別子

Merchant API では、商品 ID の形式が標準の REST リソース名に変更されました。

識別子の説明 Content API for Shopping Merchant API
商品 ID コロン(:)で区切られたセグメントで構成される文字列。
形式: channel:contentLanguage:targetCountry:offerId または channel:contentLanguage:feedLabel:offerId。
例: online:en:US:sku123
REST リソースの name 文字列。
形式: accounts/{account}/products/{product}({product} は contentLanguage~feedLabel~offerId)。
例: accounts/12345/products/en~US~sku123。
エンコード: パディングなしの base64url エンコードが推奨されます。Merchant API で使用される文字または URL 予約文字を含む商品 ID の場合は必須です。

メソッド

次の表に、Content API for Shopping のメソッドと、Merchant API でそれらに対応するメソッドを示します。

Content API for Shopping メソッド Merchant API メソッド 提供状況と注意事項
products.get products.get 最終的に処理された商品を取得します。
products.list products.list 最終的な処理済み商品を一覧表示します。
products.insert productInputs.insert 商品入力を挿入します。dataSource が必要です。
products.update productInputs.patch 動作が大きく異なります。特定の商品の入力を更新し、永続的に適用されます。
products.delete productInputs.delete 特定の商品の入力を削除します。dataSource が必要です。
products.custombatch 利用不可 非同期リクエストまたは HTTP バッチ処理を使用します。
productstatuses.get products.get productstatuses サービスが削除されます。ステータス情報が Product リソースの一部になりました。
productstatuses.list products.list productstatuses サービスが削除されます。ステータス情報が Product リソースの一部になりました。
productstatuses.custombatch 利用不可 非同期リクエストまたは HTTP バッチ処理を使用します。

フィールドの変更の詳細

次の表は、Merchant API で変更、追加、削除された重要なフィールドを示しています。

Content API for Shopping Merchant API 説明
id name 商品のプライマリ識別子は、REST リソース name になりました。パディングなしの base64url エンコードが推奨されます。Merchant API で使用される文字や URL 予約文字を含む商品名の場合は必須です。
最上位の商品データ仕様属性(例: title、price、link) productAttributes オブジェクト title、price、link などの商品属性は、最上位フィールドではなくなりました。これらは、Product リソースと ProductInput リソースの両方で productAttributes オブジェクト内にグループ化されるようになりました。これにより、リソース構造がより簡潔で整理されたものになります。
targetCountry feedLabel Merchant Center の機能に合わせて、リソース名に targetCountry ではなく feedLabel が使用されるようになりました。
feedId dataSource(クエリ パラメータ) dataSource 名が、すべての productInputs 書き込みメソッド(insert、update、delete)の必須クエリ パラメータになりました。
channel 利用できません。ローカルのみの商品には legacy_local を使用します。 channel フィールドは Merchant API に存在しなくなりました。Content API for Shopping で LOCAL チャネルが設定されている商品では、代わりに legacy_local フィールドを true に設定する必要があります。
利用不可 versionNumber ProductInput の新しいオプション フィールド。プライマリ データソースへの順不同の挿入を防ぐために使用できます。
値のセットが定義されている string 型のフィールド 値のセットが定義されている enum 型のフィールド 値のセットが定義されている商品属性内のフィールド(excluded_destinations、availability など)が enum 型になりました。
gtin productAttributes.gtins 単一の文字列(gtin)から繰り返し文字列(gtins)に変更されました。
sizes productAttributes.size 繰り返し文字列(sizes)から単一文字列(size)に変更されました。
sizeType、additionalSizeType productAttributes.sizeTypes sizeType と additionalSizeType を、最大 2 つの値(["PETITE", "MATERNITY"] など)を受け入れる繰り返し SizeType 列挙型(sizeTypes)に置き換えました。