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.
Die Merchant Products API enthält zwei Ressourcen.
productInputssteht für die Eingabeteile Ihrer Produkte.productssteht für die verarbeiteten Produkte, die aus Ihren Eingabeteilen erstellt wurden.
productInputs kann primär oder ergänzend sein, je nachdem, ob es in eine primäre Datenquelle oder eine ergänzende Datenquelle hochgeladen wird.
Jeder product wird aus einem einzigen primären productInput und einer beliebigen Anzahl von ergänzenden productInputs erstellt.
Mit der Merchant Products API können Sie Online- oder Ladengeschäftskataloge erstellen. Diese Produkte können in mehreren Shopping-Zielen erscheinen.
Sie können die productInputs-Ressource verwenden, sobald Sie Ihr Merchant Center-Konto erstellt, Ihre erste Datenquelle eingerichtet und die ersten Produkte über die API hochgeladen haben.
Händler können zwar Produkte über eine Datei hochladen, die PrimaryProductDataSource heißt, es gibt jedoch mehrere Vorteile beim Erstellen und Löschen von Produkten mit der Merchant API. Zu diesen Vorteilen gehören eine kürzere Reaktionszeit und die Möglichkeit, Produkte in Echtzeit zu aktualisieren, ohne große Dateien verwalten zu müssen. Es kann einige Stunden dauern, bis Produktänderungen, die über API-Aufrufe vorgenommen wurden, in der Shopping-Datenbank zu sehen sind.
Vorbereitung
Wenn Sie noch keine Datenquelle haben, erstellen Sie eine mit der Merchant DataSources API oder im Merchant Center.
Wenn Sie bereits eine Datenquelle haben, die Sie entweder über die Merchant Center-Benutzeroberfläche oder über die API erstellt haben, können Sie Ihre Produkte mit der Merchant Products API hinzufügen. Wenn Sie Produkte mit der Content API for Shopping hinzufügen, lesen Sie den Leitfaden zur Migration, um zu erfahren, wie Sie mit der Merchant Products API beginnen.
Sie sind dafür verantwortlich, die Richtlinien für Shopping-Anzeigen und Produkteinträge einzuhalten. Shopping Ads behält sich das Recht vor, diese Richtlinien durchzusetzen und entsprechende Maßnahmen zu ergreifen, wenn Inhalte oder Verhaltensweisen gegen diese Richtlinien verstoßen.
Ressourcen
Mit der Ressource products können Sie Produktinformationen aus der Shopping-Datenbank abrufen.
Die Ressource productInput steht für die Eingabedaten, die Sie für ein Produkt einreichen. Außerdem bietet es Methoden, mit denen Sie Produktinformationen einzeln oder im Batch-Modus auf einmal aktualisieren oder löschen können. Eine productInput-Ressource muss die folgenden Felder enthalten:
channel: Der Channel des Produkts.offerId: Die eindeutige Kennung für das Produkt.contentLanguage: Der aus zwei Buchstaben bestehende ISO 639-1-Sprachcode für das Produkt.feedLabel: Das Feedlabel für das Produkt.
Produktdaten in Ihr Konto hochladen
Verwenden Sie die Methode accounts.productInputs.insert, um eine Produkteingabe in Ihr Konto hochzuladen. Sie müssen die eindeutige Kennung der primären oder ergänzenden Datenquelle übergeben.
Ein verarbeitetes Produkt aus Ihrem Konto abrufen
Wenn Sie ein verarbeitetes Produkt aus Ihrem Konto abrufen möchten, verwenden Sie die Methode accounts.products.get. Es kann einige Minuten dauern, bis das verarbeitete Produkt nach dem Einfügen angezeigt wird.
Sie können den Ressourcennamen des verarbeiteten Produkts aus dem Feld product in der Antwort von accounts.productInputs.insert abrufen.
Produkteingabe aus Ihrem Konto löschen
Wenn Sie eine Produkteingabe aus Ihrem Konto löschen möchten, verwenden Sie die Methode accounts.productInputs.delete. Wenn Sie ein Produkt mit der Merchant Products API löschen möchten, müssen Sie die eindeutige Kennung der primären oder ergänzenden Datenquelle angeben, zu der das Produkt gehört.
Produkte aus Ihrem Konto auflisten
Verwenden Sie die Methode accounts.products.list, um die verarbeiteten Produkte in Ihrem Konto aufzulisten.