Ü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. Automatische Datenquellen erleichtern das Senden Ihrer Produktdaten an Google. 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 der Merchant Data Sources API 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 Merchant Data Sources 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 ergänzende Datenquelle, um eine Verknüpfung mit einer vorhandenen primären Datenquelle herzustellen.
  • Legen Sie einen Zeitplan für eine Dateidatenquelle fest.
  • Melden Sie sich in Ihrem Konto an, um die automatische Verwaltung von Datenquellen zu aktivieren.
  • API-Datenquellen verwalten
  • Verwalten Sie die Standardregel für Datenquellen mithilfe primärer Produktdatenquellen.
  • Verwenden Sie andere Arten von Datenquellen, z. B. Angebotsdaten.

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

Vorbereitung

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

  • Verwenden Sie die Datenquellenliste oder die Get-Methoden, um zu prüfen, ob das Konto bereits zur Aufteilung von Datenzielen migriert wurde. Wenn Sie nicht berechtigt sind, erhalten Sie die folgende Ausnahmemeldung und sollten sich 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

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 finden Sie unter PrimaryProductDataSource.

In der folgenden Beispielanfrage wird gezeigt, wie Sie eine primäre Produktdatenquelle erstellen:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "feedLabel": "{FEED_LABEL}",
    "countries": [
      "{COUNTRY}"
    ],
    "channel": "ONLINE_PRODUCTS"
  }
}

Ersetzen Sie Folgendes:

  • {ACCOUNT_ID}: Die eindeutige Kennung Ihres Merchant Center-Kontos.
  • {DISPLAY_NAME}: Der Anzeigename der Datenquelle.
  • {CONTENT_LANGUAGE}: Der aus zwei Buchstaben bestehende ISO 639-1-Sprachcode der Produkte in der Datenquelle.
  • {FEED_LABEL}: Das Feedlabel der Datenquelle.
  • {COUNTRY}: Der CLDR-Territorialcode des Ziellandes der Produkte, die über die Datenquelle hochgeladen werden.

Nachdem die Anfrage erfolgreich ausgeführt wurde, wird die folgende Antwort angezeigt:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}",
  "dataSourceId": "{DATA_SOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "{FEED_LABEL}",
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "countries": [
      "{COUNTRY}"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

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

Verwenden Sie die Methode accounts.dataSources.get oder accounts.dataSources.list, um die neu erstellte Datenquelle aufzurufen.

Neue primäre Datenquelle erstellen, die die Ausrichtung auf mehrere Länder unterstützt

Wenn Sie einen neuen Hauptfeed erstellen möchten, mit dem Sie Ihre Anzeigen auf mehrere Länder ausrichten können, konfigurieren Sie Ihre 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. Mit der Merchant Data Sources API können Sie mehrere API-Datenquellen verwenden, von denen einige ohne die Felder feedLabel und contentLanguage sein können.

Nur Datenquellen mit API-Eingabe können ohne die Felder feedLabel und contentLanguage festgelegt werden. 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 zusätzliche Datenquellen nur zum Aktualisieren vorhandener Produkte verwenden.

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

Für Datenquellen mit ergänzenden Dateien müssen die Felder feedLabel und contentLanguage festgelegt sein. Bei zusätzlichen API-Datenquellen müssen die Felder feedLabel und contentLanguage immer deaktiviert sein.

Zeitplan für die Dateidatenquelle einrichten

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

Datenquellen löschen

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

Datenquelle abrufen

Verwenden Sie die Methode accounts.dataSources.fetch, um eine in der Datenquelle konfigurierte Datei abzurufen. 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

Verwenden Sie die Methode accounts.dataSources.get, um die Datenquellenkonfiguration 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 für Patches

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 Attribute in Ihrer Datenquelle. Die Standardregel kann beim Erstellen der Datenquelle oder durch Aktualisieren einer vorhandenen Datenquelle über das Feld „Standardregel“ festgelegt werden.

Weitere Informationen zum Einrichten von Regeln finden Sie unter Regeln für Produktdatenquellen einrichten.

Mit der folgenden Beispielkonfiguration wird sichergestellt, dass alle Attribute zuerst aus der Datenquelle mit der eindeutigen Kennung 1001 übernommen werden. Anschließend werden die fehlenden Attribute aus der primären Datenquelle hinzugefügt. 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 automatisch aus Ihrem Onlineshop hinzufügen und dafür sorgen, dass sie auf den Plattformen von Google immer auf dem neuesten Stand sind.

Uploadstatus der Datei 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. Wenn Sie das Ergebnis des letzten Abrufs der Datenquelle erhalten möchten, der asynchron berechnet wird, wenn die Verarbeitung der Datenquelle abgeschlossen ist, verwenden Sie den Namens-ID latest.

GET https://merchantapi.googleapis.com/accounts/v1beta/{ACCOUNT_ID}/datasources/{DATASOURCE_ID}/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.