Merchant Products API – Übersicht

Auf dieser Seite wird erläutert, wie Sie Ihre Produkte programmatisch hochladen und verwalten können. Mit der Merchant Products API können Sie ein Produkt in eine Datenquelle einfügen oder aktualisieren, ein Produkt aus Ihrem Konto abrufen und ein Produkt aus einer Datenquelle löschen.

Mit der Ressource products können Sie einen Onlineshopkatalog erstellen. Das ist eine Liste der Produkte, die in Shopping-Anzeigen verfügbar sind. Sie können die products-Ressource verwenden, sobald Sie Ihr Merchant Center-Konto erstellt haben und einen ersten Satz Produkte über die API hochladen möchten.

Sie sind dafür verantwortlich, die Richtlinien für Shopping-Anzeigen und Produkteinträge einzuhalten. Wir behalten uns bei Shopping-Anzeigen das Recht vor, diese Richtlinien durchzusetzen und entsprechende Maßnahmen zu ergreifen, wenn wir Inhalte oder Verhaltensweisen feststellen, die gegen diese Richtlinien verstoßen.

Mit der Ressource products werden Produktinformationen in die Datenbank Shopping Merchant Center hochgeladen. Außerdem bietet er eine Reihe von Methoden, mit denen Sie im Batchmodus einzeln oder über mehrere Methoden auf Produktinformationen zugreifen, diese aktualisieren oder löschen können.

Die Ressource productInput stellt die Eingabedaten dar, die Sie für ein Produkt einreichen. Eine productInput-Ressource muss die folgenden Felder enthalten:

  • channel: Der Kanal des Produkts.
  • offerId: Die eindeutige Kennzeichnung für das Produkt. Dieser Wert ist für die Produkteingabe und das verarbeitete Produkt identisch.
  • contentLanguage: Der zweistellige ISO 639-1-Sprachcode für das Produkt.
  • feedLabel: Das Feedlabel für das Produkt.

Händler haben zwar die Möglichkeit, Produkte über eine Datei zu laden, die als Hauptfeed bezeichnet wird, bietet jedoch mehrere Vorteile, Produkte über die Merchant API zu erstellen und zu löschen. Zu diesen Vorteilen gehören schnellere Antwortzeiten und die Möglichkeit, mehrere Produkte in Echtzeit zu aktualisieren, ohne mehrere Subfeeds verwalten zu müssen. Es kann bis zu mehreren Stunden dauern, bis Produktänderungen, die über API-Aufrufe vorgenommen wurden, in der Shopping Merchant Center-Datenbank angezeigt werden.

Google kann dazu beitragen, dass bestimmte Attribute Ihrer Produkte automatisch verwaltet werden. Weitere Informationen findest du unter Automatische Verbesserungen aktivieren.

Voraussetzungen

Wenn Sie keine Datenquelle haben, erstellen Sie eine mit der Merchant Data Sources API oder im Merchant Center.

Wenn Sie bereits eine Datenquelle haben, die Sie über die Merchant Center-Benutzeroberfläche oder die API erstellt haben, können Sie Ihre Produkte mit der Merchant Products API hinzufügen. Wenn Sie die Content API for Shopping zum Hinzufügen von Produkten verwenden, finden Sie im Migrationsleitfaden Informationen zu den ersten Schritten mit der Merchant Products API.

Produkteingabe in Ihr Konto hochladen

Verwenden Sie die Methode accounts.productInputs.insert, um eine Produkteingabe in Ihr Konto hochzuladen. Du musst die eindeutige ID der primären oder ergänzenden Datenquelle übergeben, um ein Produkt über die Merchant Products API einzufügen.

Ein verarbeitetes Produkt aus Ihrem Konto abrufen

Verwenden Sie die Methode accounts.products.get, um ein verarbeitetes Produkt aus Ihrem Konto abzurufen. Es kann einige Minuten dauern, bis das verarbeitete Produkt nach dem Einfügen angezeigt wird.

Produkteingabe aus Ihrem Konto löschen

Verwenden Sie die Methode accounts.productInputs.delete, um eine Produkteingabe aus Ihrem Konto zu löschen. Du musst die eindeutige Kennzeichnung der primären oder ergänzenden Datenquelle übergeben, zu der das Produkt gehört, um ein Produkt über die Merchant Products API zu löschen.

Produkte aus Ihrem Konto auflisten

Verwenden Sie die Methode accounts.products.list, um die verarbeiteten Produkte in Ihrem Konto aufzulisten.