商品を管理する

Products サブ API を使用すると、Google Merchant Center の商品在庫をプログラムで管理できます。商品の作成、取得、更新、削除が可能で、システムを Google と直接統合できる柔軟性を備えています。

Merchant API の重要なコンセプトは、送信するデータと Google が使用する最終的な商品の区別です。この分離により、商品データのライフサイクルのモデルが明確になり、商品情報をより正確に管理できるようになります。API は、次の 2 つの主要なリソースでこれを反映します。

  • ProductInput: これは、特定のデータソースに送信する未加工の商品データを表します。これは、Merchant Center の処理が行われる前に、フィード ファイルにアップロードする行、または API 呼び出しで送信するデータに相当します。このリソースは、すべての書き込みオペレーション(insert、patch、delete)に使用します。

  • Product: これは、Merchant Center と Google サービスに表示される、最終的に処理された商品を表す読み取り専用リソースです。すべてのフィードルールと処理が適用された後、1 つのプライマリ ProductInput と 0 個以上の補助 ProductInput リソースから作成されます。このリソースには、商品の最終ステータスとデータ品質の問題が含まれます。このリソースは、すべての読み取りオペレーション(get、list)に使用します。

ProductInput リソースを使用して送信されるすべての商品属性の形式と要件は、商品データ仕様で定義されています。

Products sub-API でできること

Products サブ API を使用すると、次の主要なタスクを実行できます。各ユースケースの詳細な手順とコードサンプルについては、ガイドをご覧ください。

  • 商品を追加、管理する: アカウントに新しい商品を追加する方法、既存の商品に補助データを提供する方法、販売しなくなった商品を削除する方法について説明します。
  • 商品を頻繁に更新する: 価格や在庫状況など、頻繁に変更される商品属性を効率的に部分更新する方法について説明します。
  • 商品データと商品に関する問題を一覧表示する: 処理された商品を取得する方法、さまざまな掲載先での承認状況を確認する方法、商品の表示に影響する可能性のあるデータ品質の問題を特定する方法について説明します。

始める前に

Products サブ API を使用する前に、Merchant Center アカウントで少なくとも 1 つの API データソースを作成する必要があります。Products サブ API は、API タイプのデータソース内の商品のみを挿入または更新できます。手順については、商品アップロード用の API データソースを管理するのガイドをご覧ください。