このページでは、プログラマティックに商品をアップロードして管理する方法について説明します。Merchant Products API を使用すると、データソースに商品を挿入または更新したり、アカウントから商品を取得したり、データソースから商品を削除したりできます。
Merchant Products API には 2 つのリソースがあります。
productInputsは、商品の入力部分を表します。productsは、入力パーツから構築された処理済みプロダクトを表します。
productInputs は、メイン データソースまたは補助データソースにアップロードされるかどうかに応じて、メインまたは補助にすることができます。各 product は、単一のプライマリ productInput と任意の数の補足 productInputs から構成されます。
Merchant Products API を使用して、オンライン ショップまたはローカル ショップのカタログを作成できます。これらのカタログに登録された商品は、複数のショッピング モールに表示できます。productInputs リソースは、Merchant Center アカウントを作成して最初のデータソースを設定し、API を使用して最初の商品セットをアップロードする準備ができたら使用できます。
販売者は PrimaryProductDataSource というファイルを使用した商品のアップロードが可能ですが、Merchant API を使用して商品を作成、削除することにはいくつかの利点があります。これらの利点には、レスポンス時間の短縮や、大規模なファイルを管理することなく商品をリアルタイムで更新できる機能などがあります。API 呼び出しによって行われた商品の変更がショッピング データベースに反映されるまでには、最大で数時間かかることがあります。
前提条件
データソースがない場合は、Merchant DataSources API または Merchant Center を使用してデータソースを作成します。
Merchant Center の UI または API を使用して作成したデータソースがすでにある場合は、Merchant Products API を使用して商品を追加できます。Content API for Shopping を使用して商品を追加している場合は、移行ガイドで Merchant Products API の使用方法をご覧ください。
ショッピング広告と無料リスティングのポリシーに準拠する責任は販売者に帰属します。ショッピング広告は、これらのポリシーに違反するコンテンツや行為が見つかった場合、これらのポリシーを適用し、適切に対応する権利を留保します。
リソース
products リソースを使用すると、ショッピング データベースから商品情報を取得できます。
productInput リソースは、商品に対して送信する入力データを表します。また、商品情報を 1 つずつ、またはバッチモードで複数まとめて更新または削除できるメソッドも用意されています。productInput リソースには、次のフィールドが必要です。
channel: プロダクトのチャネル。offerId: 商品の一意の識別子。contentLanguage: 商品の 2 文字の ISO 639-1 言語コード。feedLabel: 商品のフィードラベル。
アカウントに商品入力をアップロードする
商品入力をアカウントにアップロードするには、accounts.productInputs.insert メソッドを使用します。メイン データソースまたは補助データソースの一意の ID を渡す必要があります。
アカウントから処理済みの商品を取得する
アカウントから処理済み商品を取得するには、accounts.products.get メソッドを使用します。挿入後、処理された商品が表示されるまでに数分かかることがあります。
処理された商品のリソース名は、accounts.productInputs.insert のレスポンスの product フィールドから取得できます。
アカウントから商品入力を削除する
アカウントから商品入力を削除するには、accounts.productInputs.delete メソッドを使用します。Merchant Products API を使用して商品を削除するには、商品が属するメインまたは補助のデータソースの一意の ID を渡す必要があります。
アカウントの商品を一覧表示する
アカウントで処理された商品を一覧表示するには、accounts.products.list メソッドを使用します。