プロダクト管理を移行する

Merchant API を使用すると、商品をプログラムでアップロードして管理できます。accounts.products リソースを使用すると、商品とオファーのリストであるオンライン ショップ カタログを作成できます。Merchant API を使用して商品をアップロードして管理する方法については、Merchant Products API の概要をご覧ください。

リソースの変更

Content API の products リソースと productstatuses リソースは、productInputs リソースと products リソースに置き換えられます。

Merchant API の productInputs リソースを使用して、商品情報をアップロードできます。Merchant API の product リソースを使用すると、ステータスを含む処理済み商品を取得できます。

データソースの要件

Merchant API では、商品をアップロードする際に、対象データソースを指定する必要があります。これは、メイン データソースまたは補助データソースのいずれかです。既存のデータソースを取得するには dataSources.list を使用し、新しいデータソースを作成するには dataSources.create を使用します。

また、Merchant Center の管理画面を使用してデータソースを管理することもできます。

データソースとその作成方法と管理方法の詳細については、Merchant Data sources API の概要をご覧ください。

識別子の変更

Merchant API は、name を使用して商品を識別します。プロダクトの名前は accounts/{account}/products/{product} 形式で、{product} は channel~language~feedLabel~offerId 形式です。

Content API リソースは、ID channel:language:feedLabel:offerId の各値の間に ~ ではなく : を使用していました。

すべての Merchant API 呼び出しは、ID の値の間に ~ が挿入された新しい形式を返します。レスポンスから新しい name フィールドを保存し、今後の呼び出しで使用することをおすすめします。

メソッド

Content API for Shopping と Merchant Products API の products メソッドの比較を次に示します。

Content API for Shopping	Merchant Products API
products.custombatch	利用不可
products.insert	productInputs.insert
products.update	まだご利用いただけません
products.delete	productInputs.delete
products.get	products.get
products.list	products.list
productstatuses.custombatch	利用不可
productstatuses.get	products.get
productstatuses.list	products.list

リクエスト

Content API メソッド	Content API for Shopping の URL	Merchant Products API の URL	Content API の識別子	Merchant Products API の ID
products.insert	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products	POST https://merchantapi.googleapis.com/products/v1beta/{PARENT}/productsInputs:insert?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID}	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}
products.update	PATCH https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	利用不可
products.delete	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	DELETE https://merchantapi.googleapis.com/products/v1beta/{NAME}?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID}	MERCHANT_ID、PRODUCT_ID	NAME=accounts/{MERCHANT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES}
products.get	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	GET https://merchantapi.googleapis.com/products/v1beta/{NAME}	MERCHANT_ID、PRODUCT_ID	NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES}
products.list	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products	GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}
productstatuses.get	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses/{PRODUCT_ID}	GET https://merchantapi.googleapis.com/products/v1beta/{NAME}	MERCHANT_ID、PRODUCT_ID	NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES}
productstatuses.list	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses	GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}