Übersicht über die Merchant Datasources API

Auf dieser Seite wird beschrieben, wie Sie Datenquellen, die können Sie Produkte einfügen. Automatisierte Daten Quellen erleichtern das Senden von Ihre Produktdaten an Google senden. Automatisierte Datenquellen sorgen dafür, aktuelle Informationen über relevante Produkte von Ihrer Website erreichen Google.

Mit der Content API for Shopping können Sie nur primäre Datenquellen erstellen. Mit API für Händlerdatenquellen können Sie die folgenden Arten von Datenquellen erstellen:

• Primäre Produktdatenquellen
• Zusätzliche Produktdatenquellen
• Datenquellen für lokales Inventar
• Datenquellen für regionales Inventar
• Datenquellen für Angebote

Mit der Content API for Shopping konnten nur Datenquellen mit Dateieingabe verwaltet werden. Mit der Merchant API können Sie Datenquellen sowohl mit Datei- als auch mit API-Eingaben verwalten.

Mit der Händlerdatenquellen-API haben Sie folgende Möglichkeiten:

• Erstellen Sie eine neue primäre Datenquelle mit einer bestimmten feedLabel und contentLanguage.
• Erstellen Sie eine Platzhalter-Datenquelle. Eine Platzhalter-Datenquelle hat nicht feedLabel und contentLanguage festgelegt. Mit Platzhalterdatenquellen können Sie mit unterschiedlichen Kombinationen von feedLabel und contentLanguage in Datenquelle verwendet werden.
• Erstellen Sie eine ergänzende Datenquelle, um eine Verknüpfung mit einer vorhandenen primären Datenquelle zu erstellen.
• Richten Sie einen Zeitplan für eine Dateidatenquelle ein.
• Registrieren Sie Ihr Konto für die automatische Verwaltung von Datenquellen.
• API-Datenquellen verwalten
• Verwalten Sie die Standardregel von Datenquellen mithilfe primärer Produktdatenquellen.
• Verwenden Sie andere Arten von Datenquellen wie z. B. Angebote.

Vorbereitung

• Ihr Konto muss zu Feeds mit nur einer Sprache migriert worden sein.

• Um zu prüfen, ob das Konto bereits zur Datenzielaufteilung migriert wurde, verwenden Sie die Methode Datenquellenliste oder get-Methoden. Solltest du nicht teilnahmeberechtigt sein, erhältst du die folgende Ausnahmemeldung erhalten, und wenden Sie sich an den Support.

  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.
  

Neue Datenquelle erstellen

Um eine neue primäre Datenquelle mit einer bestimmten feedLabel und contentLanguage, legen Sie die Felder feedLabel und contentLanguage in der typspezifische Konfiguration. Zum Beispiel: PrimaryProductDataSource.

Wenn Sie die neu erstellte Datenquelle aufrufen möchten, erstellen Sie eine GET- oder LIST-Anfrage.

Neue primäre Platzhalterdatenquelle erstellen

Um einen neuen Platzhalter-Hauptfeed zu erstellen, konfigurieren Sie Ihre Datenquelle mit PrimaryProductDataSource und legen Sie nicht die Felder feedLabel und contentLanguage fest.

Bei der Content API for Shopping wird nur eine API-Datenquelle für von dir. Mit der Merchant Data Source API können Sie mehrere API-Datenquellen haben, von denen einige Platzhalter sein können.

Nur Datenquellen mit API-Eingabe können Platzhalterdatenquellen sein. Platzhalterdaten Quellen werden für Dateieingaben nicht unterstützt.

Zusätzliche Datenquelle erstellen und mit der primären Datenquelle verknüpfen

Sie können zusätzliche Datenquellen verwenden, um Produktdaten teilweise zu aktualisieren, indem Sie die eindeutige Kennzeichnung der Datenquelle als Suchparameter hinzufügen, wenn Aufrufe an die accounts.productInputs.insert und accounts.productInputs.delete . Sie können ergänzende Datenquellen nur verwenden, um vorhandene Produkte zu aktualisieren.

Um eine ergänzende Datenquelle zu erstellen, konfigurieren Sie die Datenquelle mit SupplementalProductDataSource und verknüpfen Sie es dann durch Aktualisieren des defaultRule in Ihrer primären Datenquelle.

Datenquellen für zusätzliche Dateien dürfen keine Platzhalterdatenquellen sein. Ergänzende API Datenquellen müssen immer Platzhalterdatenquellen sein.

Zeitplan für die Dateidatenquelle einrichten

Wenn Sie einen Zeitplan für Ihren Dateifeed einrichten möchten, müssen Sie die Datenquelle als Datei konfigurieren indem Sie das Feld FileInput verwenden und dann fetchsettings mithilfe des Felds FileInput.FetchSettings.

Datenquellen löschen

Wenn Sie eine vorhandene Datenquelle aus Ihrem Konto löschen möchten, verwenden Sie den accounts.dataSources.delete .

Datenquelle abrufen

Wenn Sie eine in der Datenquelle konfigurierte Datei abrufen möchten, verwenden Sie den accounts.dataSources.fetch . Diese Methode führt den Datenabruf sofort für eine Datenquelle von in Ihrem Konto. Diese Methode funktioniert nur bei Datenquellen mit einem Dateieingabesatz.

Datenquelle abrufen

Um die Konfiguration der Datenquelle für Ihr Konto abzurufen, verwenden Sie den accounts.dataSources.get .

Datenquelle auflisten

Um die Konfigurationen für Datenquellen für Ihr Konto aufzulisten, verwenden Sie die accounts.dataSources.list .

Datenquelle patchen

Um die Konfiguration einer vorhandenen Datenquelle zu aktualisieren, verwenden Sie den accounts.dataSources.patch .

Datenquellen verknüpfen

Über primäre Produktdatenquellen können Sie die standardmäßigen Regel von Datenquellen. Die Standardregel gilt für alle in Ihrer Datenquelle verwenden. Die Standardregel kann beim Erstellen der Datenquelle verwenden oder eine vorhandene Datenquelle über die Standardregel aktualisieren ein.

Mit der folgenden Beispielkonfiguration wird sichergestellt, dass alle Attribute zuerst verwendet werden aus der Datenquelle mit der eindeutigen Kennzeichnung 1001. Dann kommen die fehlenden Attribute aus der primären Datenquelle hinzugefügt werden. Schließlich werden die verbleibenden Attribute werden aus der ergänzenden Datenquelle mit den eindeutigen ID 1002, sofern nicht bereits in einer anderen Datenquelle angegeben. Wenn dieselbe in mehreren Datenquellen bereitgestellt wird, ist der Wert, der in der Liste oben steht, ausgewählt.

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

Hinweis :Benutzerdefinierte Regeln können nicht über die API geändert werden.

Automatische Verwaltung von Feeds

Um Ihr Konto für die automatische Verwaltung von Datenquellen anzumelden, müssen Sie die folgenden Schritte ausführen: Folgendes:

• Prüfen Sie, ob Ihr Konto zur Registrierung berechtigt ist, indem Sie auf der Accounts.AutofeedSettings.Get-Methode.
• Vergewissern Sie sich, dass Ihr Konto kein Marktplatz ist. Konto.

Sobald Ihr Konto für die Registrierung infrage kommt, können Sie die Accounts.AutofeedSettings.Update-Methode zur Aktivierung der automatischen Datenverwaltung Quellen. Wenn Sie die automatische Verwaltung von Datenquellen aktivieren, kann Google automatisch Produkte aus Ihrem Onlineshop hinzufügen und dafür sorgen, dass sie immer auf dem neuesten Stand sind auf den Plattformen von Google.

Dateiuploadstatus abrufen

Um den Status einer Datenquelle mit Datei, Abruf oder Tabelle abzurufen, gehen Sie wie folgt vor: kann die Methode GET des Dienstes FileUpload aufrufen. Um das Ergebnis einer den letzten Abruf der Datenquelle, die asynchron berechnet wurde, als die Daten Quellverarbeitung abgeschlossen ist, verwenden Sie die Namenskennung latest.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

Der Datei-Uploadstatus kann eine detaillierte Ansicht Ihrer Produkte enthalten, einschließlich mögliche Probleme beheben.

Der Uploadstatus der Datei ist möglicherweise nicht vorhanden, wenn die Datei nie hochgeladen wurde. Der Datei-Upload-Status kann den Status „Verarbeitung“ haben, wenn die Anfrage kurz nach dem wird die Datei hochgeladen.