Übersicht über die Merchant Datasources API

Auf dieser Seite erfahren Sie, wie Sie Ihre Datenquellen, mit denen Sie Produkte einfügen können, programmatisch erstellen und aktualisieren. Automatisierte Daten Quellen erleichtern das Senden von Ihre Produktdaten an Google senden. Mit automatischen Datenquellen wird sichergestellt, dass Google immer die aktuellsten Informationen zu relevanten Produkten von Ihrer Website erhält.

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:

Mit der Content API for Shopping können Sie nur Datenquellen mit Dateieingabe verwalten. Mit der Merchant API können Sie Datenquellen sowohl über Datei- als auch API-Eingabe 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 Datenquelle, für die keine feedLabel- und contentLanguage-Felder festgelegt sind. Mit dieser Art von Datenquelle können Sie Ihre Produkte auf mehrere Länder ausrichten, da Sie Produkte mit verschiedenen Kombinationen von feedLabel und contentLanguage in eine einzige Datenquelle einfügen können.
  • Erstellen Sie eine zusätzliche 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, z. B. Angebote.

Sie können die Merchant API nicht verwenden, um Produkte in eine Datenquelle einzufügen, die sowohl für lokale als auch für Onlineprodukte. Weitere Informationen zu Datenquellenkanälen finden Sie unter Kanäle.

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

Primäre Datenquellen sind die wichtigsten Datenquellen für Ihr Merchant Center-Inventar. Produkte können nur über eine primäre Datenquelle hinzugefügt oder entfernt werden. Wenn jedes Produkt, das Sie Ihrer primären Datenquelle hinzufügen, die Datenanforderungen und Eignungsvoraussetzungen des Merchant Centers erfüllt, müssen Sie keine weiteren Datenquellen erstellen.

Wenn Sie eine neue primäre Datenquelle mit einer bestimmten feedLabel und contentLanguage erstellen möchten, legen Sie die Felder feedLabel und contentLanguage in der typspezifischen Konfiguration fest. Weitere Informationen zu diesen Feldern Weitere Informationen finden Sie unter PrimaryProductDataSource.

Weitere Informationen zum Erstellen einer Datenquelle finden Sie in der accounts.dataSources.create .

Um die neu erstellte Datenquelle aufzurufen, verwenden Sie den accounts.dataSources.get oder accounts.dataSources.list .

Neue primäre Datenquelle für die Ausrichtung auf mehrere Länder erstellen

Wenn Sie einen neuen Hauptfeed erstellen möchten, mit dem Sie Ihre Anzeigen auf mehrere Länder ausrichten können, konfigurieren Sie Ihre Datenquelle mithilfe von 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, bei einigen davon müssen die Felder feedLabel und contentLanguage nicht festgelegt sein.

Nur Datenquellen mit API-Eingabe dürfen ohne feedLabel und contentLanguage Felder festgelegt. Dieser Datenquellentyp wird für Dateieingaben nicht unterstützt.

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

Zusätzliche Datenquellen dienen nur zum Aktualisieren von Produktdaten, die bereits in einer oder mehreren primären Datenquellen vorhanden sind. Sie können mehrere ergänzende Datenquellen verwenden, die jeweils Daten beliebig vieler Hauptdatenquellen ergänzen.

Sie können ergänzende Datenquellen verwenden, um Produktdaten teilweise zu aktualisieren. Fügen Sie dazu die eindeutige Kennung der Datenquelle als Abfrageparameter hinzu, wenn Sie die Methoden accounts.productInputs.insert und accounts.productInputs.delete aufrufen. 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.

Zusätzliche Dateidatenquellen müssen die feedLabel und contentLanguage haben festgelegt. Zusätzliche API-Datenquellen müssen immer die feedLabel und Festlegung der contentLanguage-Felder aufgehoben.

Zeitplan für die Dateidatenquelle einrichten

Wenn Sie einen Zeitplan für Ihren Dateifeed einrichten möchten, konfigurieren Sie Ihre Datenquelle als Dateidatenquelle. Verwenden Sie dazu das Feld FileInput und richten Sie dann fetchsettings mit dem Feld FileInput.FetchSettings ein.

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 . Bei dieser Methode wird der Datenabruf sofort in einer Datenquelle in Ihrem Konto ausgeführt. Diese Methode funktioniert nur für Datenquellen mit einer festgelegten Dateieingabe.

Datenquelle abrufen

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

Datenquelle auflisten

Verwenden Sie die Methode accounts.dataSources.list, um die Konfigurationen für Datenquellen für Ihr Konto aufzulisten.

Datenquelle patchen

Verwenden Sie die Methode accounts.dataSources.patch, um die Konfiguration einer vorhandenen Datenquelle zu aktualisieren.

Mit primären Produktdatenquellen können Sie die StandardRegel für Datenquellen verwalten. Die Standardregel gilt für alle in Ihrer Datenquelle verwenden. Die Standardregel kann beim Erstellen der Datenquelle oder durch Aktualisieren einer vorhandenen Datenquelle über das Feld „Standardregel“ festgelegt werden.

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. Die verbleibenden Attribute werden schließlich aus der zusätzlichen Datenquelle mit der eindeutigen Kennung 1002 übernommen, sofern sie nicht bereits in einer anderen Datenquelle bereitgestellt wurden. Wenn dasselbe Attribut in mehreren Datenquellen angegeben ist, wird der Wert ausgewählt, der in der Liste höher steht.

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

Automatische Verwaltung von Feeds

So registrieren Sie Ihr Konto für die automatische Verwaltung von Datenquellen:

Sobald Ihr Konto für die Registrierung infrage kommt, können Sie die automatische Verwaltung von Datenquellen mit der Methode accounts.autofeedSettings.updateAutofeedSettings aktivieren. Wenn Sie die automatische Verwaltung von Datenquellen aktivieren, kann Google Ihre Produkte aus Ihrem Onlineshop automatisch hinzufügen und dafür sorgen, dass sie auf den Plattformen von Google immer auf dem neuesten Stand sind.

Dateiuploadstatus abrufen

Wenn Sie den Status einer Datenquelle mit einer Datei, einem Abruf oder einer Tabelle abrufen möchten, können Sie die Methode GET des Dienstes accounts.dataSources.fileUploads aufrufen. Um das Ergebnis des letzten Abrufs der berechneten Datenquelle zu erhalten wenn die Verarbeitung der Datenquelle abgeschlossen ist, verwenden Sie den Namen ID latest.

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

Der Dateiuploadstatus kann eine detaillierte Ansicht Ihrer Produkte enthalten, einschließlich potenzieller Probleme.

Hinweis: Der Dateiuploadstatus ist möglicherweise nicht vorhanden, wenn die Datei nie hochgeladen wurde. Der Status des Dateiuploads kann „Wird verarbeitet“ sein, wenn die Anfrage kurz nach dem Upload erfolgt.