Merchant Data Sources API の概要

このページでは、次の条件を満たすデータソースをプログラマティックに作成および更新する方法について説明します。 商品を挿入できます自動化されたデータ ソースを使用すると、 商品データを Google に送信できます自動化されたデータソースにより 貴社のウェブサイトの関連商品に関する最新情報が Google に届きます。

Content API for Shopping で作成できるのはメイン データソースのみです。あり Merchant Data source API を使用する場合は、次のタイプのデータソースを作成できます。

Content API for Shopping では、ファイル入力を使用したデータソースの管理のみ可能でした。 Merchant API では、ファイルと API の両方の入力を使用してデータソースを管理できます。

Merchant Data source API を使用すると、次のことができます。

  • 特定の feedLabel を使用して新しいプライマリ データソースを作成します。 contentLanguage。
  • ワイルドカード データソースを作成します。ワイルドカード データソースに feedLabel は使用できません。 と contentLanguage フィールドが設定されます。ワイルドカードデータソースでは feedLabel と contentLanguage の組み合わせが異なる商品を データソースです
  • 補助データソースを作成して、既存のメイン データソースにリンクします。
  • ファイル データソースのスケジュールを設定します。
  • API データソースを管理します。
  • プロモーションなど、他のタイプのデータソースを使用します。

前提条件

  • アカウントが単一の言語 / 地域のフィードに移行されている必要があります。

  • アカウントがすでにデータ ターゲット分割に移行されていることを確認するには、次のコマンドを使用します。 または get メソッドを使用します。対象とならない場合は、 次の例外メッセージが表示されます。サポートにお問い合わせください。

    This account is in the data sources migration process and can't be used with
this API yet. Contact support for more info on when this account will be able
to use the data sources endpoint.

新しいデータソースを作成する

特定の feedLabel と新しいプライマリ データソースを contentLanguage の場合は、contentLanguagefeedLabel 構成する必要があります。例: PrimaryProductDataSource。

新しく作成したデータソースを表示するには、GET リクエストまたは LIST リクエストを作成します。

ワイルドカードを使ったプライマリ データソースを新規作成する

新しいワイルドカード メインフィードを作成するには、 PrimaryProductDataSource feedLabel フィールドと contentLanguage フィールドは設定しないでください。

Content API for Shopping に対して作成されている API データソースは 1 つのみです できます。Merchant Data Sources API を使用すると、複数の API データソースを使用でき、 その一部はワイルドカードです。

ワイルドカード データソースにできるのは、API 入力を持つデータソースのみです。ワイルドカード データ ファイル入力ではサポートされていません。

補助データソースを作成し、メイン データソースにリンクする

補助データソースを使用すると、次の方法で商品データを部分更新できます。 作成時に、データソースの一意の識別子をクエリ パラメータとして追加する 呼び出し accounts.productInputs.insert および accounts.productInputs.delete あります。既存の商品の更新に使用できるのは、補助データソースのみです。

補助データソースを作成するには、 SupplementalProductDataSourceしてから、defaultRule を更新してリンクします。 フィールドで確認できます。

補助ファイルのデータソースをワイルドカード データソースにすることはできません。補助 API データソースは常にワイルドカード データソースである必要があります。

ファイル データソースのスケジュールを設定する

ファイル フィードのスケジュールを設定するには、データソースをファイルに構成してください FileInput フィールドを使用してデータソースを作成し、 fetchsettings FileInput.FetchSettingsフィールドを使用します

データソースを削除する

アカウントから既存のデータソースを削除するには、 accounts.dataSources.delete メソッドを呼び出します。

データソースを取得

データソースに設定されているファイルを取得するには、次のコマンドを使用します。 accounts.dataSources.fetch メソッドを呼び出します。このメソッドは、 ログインします。このメソッドは、ファイル入力が設定されているデータソースでのみ機能します。

データソースを取得

アカウントのデータソース設定を取得するには、次のコマンドを使用します。 accounts.dataSources.get メソッドを呼び出します。

データソースの一覧表示

アカウントのデータソースの設定を一覧表示するには、次のコマンドを使用します。 accounts.dataSources.list メソッドを呼び出します。

データソースにパッチを適用

既存のデータソースの構成を更新するには、次のコマンドを使用します。 accounts.dataSources.patch メソッドを呼び出します。