このページでは、商品をプログラムでアップロードして管理する方法について説明します。Merchant Products API を使用すると、データソースへの商品の挿入または更新、アカウントからの商品の取得、データソースからの商品の削除を行うことができます。
products リソースを使用して、オンライン ショップ カタログ（ショッピング広告で購入できる商品のリスト）を作成できます。Merchant Center アカウントを作成し、API で最初の商品セットをアップロードする準備ができたら、products リソースを使用できます。
販売者には、ショッピング広告と無料リスティングのポリシーを遵守する責任があります。ショッピング広告は、これらのポリシーを適用し、ポリシーに違反するコンテンツや行為が検出された際に適切に対処する権利を有します。
products リソースは、商品情報を Shopping Merchant Center データベースにアップロードします。また、商品情報に対して一度に 1 つずつ、またはバッチモードで一度に多数の商品情報にアクセス、更新、削除できる方法も多数用意されています。
productInput リソースは、商品に登録する入力データを表します。productInput リソースには次のフィールドが必要です。
channel: 商品のチャネル。offerId: 商品の一意の識別子。この値は、商品入力と処理済み商品で同じです。contentLanguage: 商品の 2 文字の ISO 639-1 言語コード。feedLabel: 商品のフィードラベル。
販売者はメインフィードと呼ばれるファイルを使用して商品を読み込むことができますが、Merchant API を使用して商品を作成、削除するメリットはいくつかあります。これには、応答時間が短縮される、複数の補助フィードを管理することなく、複数の商品をリアルタイムで更新できることなどが挙げられます。API 呼び出しによる商品の変更が Shopping Merchant Center データベースに反映されるまでに、数時間かかることがあります。
Google は、商品の特定の属性を自動的に維持するお手伝いをします。詳細については、自動改善を有効にするをご覧ください。
前提条件
データソースがない場合は、Merchant Data sources API または Merchant Center を使用してデータソースを作成します。
Merchant Center の管理画面または API を使用して作成したデータソースがすでにある場合は、Merchant Products API を使用して商品を追加できます。Content API for Shopping を使用して商品を追加している場合は、移行ガイドを参照し、Merchant Products API の使用方法を確認してください。
アカウントに商品入力をアップロードする
アカウントに商品入力をアップロードするには、accounts.productInputs.insert メソッドを使用します。Merchant Products API を使用して商品を挿入するには、プライマリ データソースまたは補助データソースの一意の識別子を渡す必要があります。
処理済みの商品をアカウントから取得する
処理済みの商品をアカウントから取得するには、accounts.products.get メソッドを使用します。挿入後、処理済みの商品が表示されるまでに数分かかることがあります。
アカウントから商品入力を削除する
アカウントから商品入力を削除するには、accounts.productInputs.delete メソッドを使用します。Merchant Products API を使用して商品を削除するには、商品が属するプライマリ データソースまたは補助データソースの一意の識別子を渡す必要があります。
アカウントの商品を一覧表示する
アカウント内の処理済み商品を一覧表示するには、accounts.products.list メソッドを使用します。