このページでは、商品を挿入できるデータソースをプログラムで作成および更新する方法について説明します。自動化されたデータソースを使用すると、商品データを 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 を使用して新しいプライマリ データソースを作成するには、タイプ固有の構成で feedLabel フィールドと contentLanguage フィールドを設定します。例: PrimaryProductDataSource。
新しく作成したデータソースを表示するには、GET リクエストまたは LIST リクエストを作成します。
ワイルドカードを使ったプライマリ データソースを新規作成する
新しいワイルドカード メインフィードを作成するには、PrimaryProductDataSource を使用してデータソースを設定し、feedLabel フィールドと contentLanguage フィールドを設定しないでください。
Content API for Shopping を使用した場合、API データソースは 1 つだけ作成されます。Merchant Data source API を使用すると、複数の API データソースを設定できます。また、その一部をワイルドカードにすることもできます。
ワイルドカード データソースにできるのは、API 入力を持つデータソースのみです。ワイルドカード データソースは、ファイル入力ではサポートされていません。
補助データソースを作成し、メイン データソースにリンクする
補助データソースを使用して商品データを部分的に更新するには、accounts.productInputs.insert メソッドと accounts.productInputs.delete メソッドの呼び出し時に、データソースの一意の識別子をクエリ パラメータとして追加します。既存の商品の更新に使用できるのは、補助データソースのみです。
補助データソースを作成するには、SupplementalProductDataSource を使用してデータソースを構成し、プライマリ データソースの defaultRule フィールドを更新してリンクします。
補助ファイルのデータソースをワイルドカード データソースにすることはできません。補助 API データソースは常にワイルドカード データソースである必要があります。
ファイル データソースのスケジュールを設定する
ファイル フィードのスケジュールを設定するには、FileInput フィールドを使用してデータソースがファイル データソースとなるように構成してから、FileInput.FetchSettings フィールドを使用して fetchsettings を設定します。
データソースを削除する
アカウントから既存のデータソースを削除するには、accounts.dataSources.delete メソッドを使用します。
データソースを取得
データソースで構成されているファイルを取得するには、accounts.dataSources.fetch メソッドを使用します。このメソッドは、アカウントのデータソースですぐにデータを取得します。このメソッドは、ファイル入力が設定されているデータソースでのみ機能します。
データソースを取得
アカウントのデータソース構成を取得するには、accounts.dataSources.get メソッドを使用します。
データソースの一覧表示
アカウントのデータソースの構成を一覧表示するには、accounts.dataSources.list メソッドを使用します。
データソースにパッチを適用する
既存のデータソースの構成を更新するには、accounts.dataSources.patch メソッドを使用します。