Übersicht über die Merchant Datasources API

Auf dieser Seite wird beschrieben, wie Sie Datenquellen, über die Sie Produkte einfügen können, programmatisch erstellen und aktualisieren können. Automatisierte Datenquellen erleichtern das Senden Ihrer Produktdaten an Google. Automatisierte Datenquellen sorgen dafür, dass Google immer aktuelle Informationen zu relevanten Produkten von Ihrer Website erhält.

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

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 Merchant Data Source API haben Sie folgende Möglichkeiten:

  • Erstellen Sie eine neue primäre Datenquelle mit einer bestimmten feedLabel und contentLanguage.
  • Erstellen Sie eine Platzhalter-Datenquelle. Für eine Datenquelle mit Platzhaltern sind die Felder feedLabel und contentLanguage nicht festgelegt. Mit Platzhalterdatenquellen können Sie Produkte mit unterschiedlichen Kombinationen von feedLabel und contentLanguage in eine Datenquelle einfügen.
  • 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.
  • API-Datenquellen verwalten
  • Verwenden Sie andere Arten von Datenquellen wie z. B. Angebote.

Voraussetzungen

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

  • Verwenden Sie die Datenquellenliste oder die get-Methoden, um zu prüfen, ob das Konto bereits zur Datenzielaufteilung migriert wurde. Solltest du die Voraussetzungen nicht erfüllen, erhältst du die folgende Ausnahmenachricht und musst dich an den Support wenden.

    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

Wenn Sie eine neue primäre Datenquelle mit einem bestimmten feedLabel und contentLanguage erstellen möchten, legen Sie in der typspezifischen Konfiguration die Felder feedLabel und contentLanguage fest. Zum Beispiel: PrimaryProductDataSource.

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

Neue primäre Platzhalterdatenquelle erstellen

Wenn Sie einen neuen Hauptfeed mit Platzhaltern erstellen möchten, konfigurieren Sie die Datenquelle mit PrimaryProductDataSource und legen Sie die Felder feedLabel und contentLanguage nicht fest.

Wenn Sie die Content API for Shopping verwenden, wird nur eine API-Datenquelle für Sie erstellt. Wenn Sie die Merchant Data Resources API verwenden, können Sie mehrere API-Datenquellen haben, von denen einige Platzhalter sein können.

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

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

Sie können mithilfe von zusätzlichen Datenquellen auch teilweise Aktualisierungen an Produktdaten vornehmen. Dazu fügen Sie bei Aufrufen der Methoden accounts.productInputs.insert und accounts.productInputs.delete die eindeutige Kennzeichnung der Datenquelle als Abfrageparameter hinzu. Sie können ergänzende Datenquellen nur verwenden, um vorhandene Produkte zu aktualisieren.

Wenn Sie eine zusätzliche Datenquelle erstellen möchten, konfigurieren Sie die Datenquelle mit SupplementalProductDataSource und verknüpfen Sie sie dann, indem Sie das Feld defaultRule in Ihrer primären Datenquelle aktualisieren.

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

Zeitplan für die Dateidatenquelle einrichten

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

Datenquellen löschen

Verwenden Sie die Methode accounts.dataSources.delete, um eine vorhandene Datenquelle aus Ihrem Konto zu löschen.

Datenquelle abrufen

Wenn Sie eine in der Datenquelle konfigurierte Datei abrufen möchten, verwenden Sie die Methode accounts.dataSources.fetch. Bei dieser Methode werden die Daten sofort für eine Datenquelle aus Ihrem Konto abgerufen. Diese Methode funktioniert nur bei Datenquellen mit einem Dateieingabesatz.

Datenquelle abrufen

Verwenden Sie die Methode accounts.dataSources.get, um die Konfiguration der Datenquelle für Ihr Konto abzurufen.

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.