このページでは、商品を挿入できるデータソースをプログラムで作成して更新する方法について説明します。自動化されたデータ ソースを使用すると、 商品データを Google に送信できます自動化されたデータソースにより 貴社のウェブサイトから関連商品に関する最新情報が Google に届きます。
Content API for Shopping で作成できるのはメイン データソースのみです。Merchant Data sources API を使用すると、次のタイプのデータソースを作成できます。
Content API for Shopping では、ファイル入力でのみデータソースを管理できます。Merchant API を使用すると、ファイルと API の両方の入力を使用してデータソースを管理できます。
Merchant Data source API を使用すると、次のことができます。
- 特定の
feedLabelとcontentLanguageを使用して新しいメイン データソースを作成します。 feedLabelとcontentLanguageを含まないデータソースを作成する 設定されます。このタイプのデータソースを使用すると、複数の国をターゲットに設定できます 異なる組み合わせで商品を挿入できるため、feedLabelとcontentLanguageを 1 つのデータソースに統合します。- 既存のプライマリ データソースにリンクする補助データソースを作成します。
- ファイル データソースのスケジュールを設定します。
- アカウントを登録して、データソースを自動的に管理します。
- API データソースを管理します。
- プライマリ商品データソースを使用して、データソースのデフォルト ルールを管理します。
- プロモーションなど、他の種類のデータソースを使用する。
Merchant API を使用して、次を含むデータソースに商品を挿入することはできません オンライン商品の両方を宣伝しますデータソースについて詳しくは 詳しくは、 チャネル。
前提条件
- アカウントが単一の言語 / 地域のフィードに移行されている必要があります。
アカウントがデータ ターゲット分割にすでに移行されていることを確認するには、データソースのリストまたは取得メソッドを使用します。対象とならない場合は、 次の例外メッセージが表示されます。サポートにお問い合わせください。
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.
新しいデータソースを作成する
メイン データソースは、Merchant Center のメイン データソースです できます。商品を追加または削除できるのは、メイン データソースを使用した場合のみです。メインのデータソースに追加する商品がすべて Merchant Center のデータ要件と利用資格要件を満たしている場合、データソースを追加作成する必要はありません。
特定の feedLabel と新しいプライマリ データソースを
contentLanguage の場合は、contentLanguagefeedLabel
構成する必要があります。これらのフィールドの詳細については、PrimaryProductDataSource をご覧ください。
データソースの作成の詳細については、accounts.dataSources.create メソッドをご覧ください。
新しく作成したデータソースを表示するには、 accounts.dataSources.get または accounts.dataSources.list メソッドを呼び出します。
複数の国をターゲットにする新しいメイン データソースを作成する
複数の国をターゲットとする新しいメインフィードを作成するには、PrimaryProductDataSource を使用してデータソースを構成し、feedLabel フィールドと contentLanguage フィールドを設定しないでください。
Content API for Shopping に対して作成された API データソースは 1 つだけ
できます。Merchant Data sources API を使用すると、複数の API データソースを設定できます。一部のデータソースでは、feedLabel フィールドと contentLanguage フィールドを設定しないこともできます。
feedLabel と
contentLanguage フィールドが設定されました。このタイプのデータソースは、ファイル入力ではサポートされていません。
補助データソースを作成し、メイン データソースにリンクする
補助データソースは、すでに追加されている商品データを更新する場合にのみ使用します プライマリ データソースに存在する必要があります。補助データソースは複数作成でき、1 つの補助データソースで複数のメインデータソースのデータを補完できます。
補助データソースを使用して商品データを部分的に更新するには、accounts.productInputs.insert メソッドと accounts.productInputs.delete メソッドを呼び出すときに、データソースの一意の識別子をクエリ パラメータとして追加します。既存の商品の更新に使用できるのは、補助データソースのみです。
補助データソースを作成するには、SupplementalProductDataSource を使用してデータソースを構成し、メイン データソースの defaultRule フィールドを更新してリンクします。
補足ファイルのデータソースには、feedLabel フィールドと contentLanguage フィールドを設定する必要があります。補足 API データソースでは、feedLabel フィールドと contentLanguage フィールドは常に未設定にする必要があります。
ファイル データソースのスケジュールを設定する
ファイルフィードのスケジュールを設定するには、FileInput フィールドを使用してデータソースをファイルデータソースとして構成し、FileInput.FetchSettings フィールドを使用して fetchsettings を設定します。
データソースを削除する
アカウントから既存のデータソースを削除するには、accounts.dataSources.delete メソッドを使用します。
データソースを取得
データソースで構成されたファイルを取得するには、accounts.dataSources.fetch メソッドを使用します。この方法では、アカウントのデータソースでデータの取得が直ちに実行されます。このメソッドは、ファイル入力が設定されているデータソースでのみ機能します。
データソースの取得
アカウントのデータソース構成を取得するには、accounts.dataSources.get メソッドを使用します。
データソースの一覧表示
アカウントのデータソースの構成を一覧表示するには、accounts.dataSources.list メソッドを使用します。
パッチ データソース
既存のデータソースの構成を更新するには、次のコマンドを使用します。
accounts.dataSources.patch
メソッドを呼び出します。
データソースをリンクする
[メインの商品データソース] では、デフォルトの ルールで識別されます。デフォルト ルールは、すべての おすすめします。デフォルトのルールは、データソースの作成時に設定するか、デフォルトのルール フィールドを使用して既存のデータソースを更新することで設定できます。
次の構成例では、一意の識別子 1001 を持つデータソースから、すべての属性が最初に取得されます。その後、不足している属性がプライマリ データソースから追加されます。最終的には、
補足データソースから取得され、一意の ID を持つ
識別子 1002（他のデータソースでまだ提供されていない場合）。複数のデータソースで同じ属性が指定されている場合、リスト内の値が優先されます。
defaultRule {
takeFromDataSources: [
'1001', // Supplemental product data source
'self', // Self reference to the primary data source
'1002' // Supplemental product data source
]
}
フィードの自動管理
データソースの自動管理にアカウントを登録するには、次の操作を行う必要があります。
- アカウントが登録の対象かどうかを確認するには、
accounts.autofeedSettings.getAutofeedSettingsメソッドを呼び出します。 - アカウントがショッピングモール アカウントではないことを確認します。
アカウントが登録可能になると、
accounts.autofeedSettings.updateAutofeedSettings
メソッドを使用すると、データソースの自動管理を有効にできます。自動
データソースの管理を使用すると、Google が
Google のプラットフォームで常に最新の状態に保ちます。
ファイルのアップロード ステータスを取得する
ファイル、フェッチ、スプレッドシートを使用してデータソースのステータスを取得するには、accounts.dataSources.fileUploads サービスの GET メソッドを呼び出します。データソースの処理が完了したときに非同期で計算されたデータソースの最後の取得結果を取得するには、名前 ID latest を使用します。
GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest
ファイルのアップロード ステータスには、次のような商品の詳細ビューが含まれる場合があります。 判断してください
ファイルがアップロードされていない場合は、ファイルのアップロード ステータスが存在しないことがあります。 アップロード後すぐにリクエストされた場合、ファイル アップロード ステータスが処理中の状態になることがあります。 ファイルがアップロードされます。