このページでは、次の条件を満たすデータソースをプログラマティックに作成および更新する方法について説明します。 商品を挿入できます自動化されたデータ ソースを使用すると、 商品データを 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
の場合は、contentLanguage
feedLabel
構成する必要があります。例: 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
メソッドを呼び出します。
データソースをリンクする
[メインの商品データソース] では、デフォルトの ルールで識別されます。デフォルト ルールは、すべての おすすめします。デフォルト ルールはルールの作成時に 更新するか、デフォルトのルールで既存のデータソースを更新します。 表示されます。
次のサンプル構成では、すべての属性が最初に取得されるようにします。
一意の識別子 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.Get
メソッドを使用します。 - アカウントがショッピングモールではないことを確認します。 。
アカウントが登録可能になると、
データの自動管理を有効にする Accounts.AutofeedSettings.Update
メソッド
あります。データソースの自動管理を有効にすると
オンライン ショップから商品を追加して、常に最新の状態に保ちましょう
掲載されています
ファイルのアップロード ステータスを取得する
ファイル、フェッチ、スプレッドシートのいずれかでデータソースのステータスを取得するには、次の操作を行います。
FileUpload
サービスの GET
メソッドを呼び出すことができます。結果を取得するには、
非同期で計算されたデータソースの最後の取得。
ソース処理が完了したら、名前 ID latest
を使用します。
GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest
ファイルのアップロード ステータスには、次のような商品の詳細ビューが含まれる場合があります。 判断してください
ファイルがアップロードされていない場合は、ファイルのアップロード ステータスが存在しないことがあります。 アップロード後すぐにリクエストされた場合、ファイル アップロード ステータスが処理中の状態になることがあります。 ファイルがアップロードされます。