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)に置き換えました。 |