Produkte migrieren

Die Merchant API bietet eine robustere und intuitivere Möglichkeit, Ihre Produktdaten zu verwalten. Die wichtigste Änderung ist die Aufteilung der Produktdaten in zwei separate Ressourcen: ProductInput zum Einreichen Ihrer Daten und Product zum Aufrufen der endgültigen, verarbeiteten Version mit Produktstatus und ‑problemen. Diese neue Struktur sorgt für mehr Vorhersehbarkeit und Transparenz.

In diesem Leitfaden werden die wichtigsten Unterschiede beschrieben, damit Sie Ihre Integration von der Content API for Shopping migrieren können. Eine detaillierte Anleitung zur Verwendung der neuen Funktionen finden Sie unter Produkte verwalten.

Wichtige Unterschiede

Im Folgenden finden Sie die wichtigsten Änderungen bei der Verwaltung von Produkten in der Merchant API im Vergleich zur Content API for Shopping:

  • Eigene Ressourcen für Eingabe- und verarbeitete Daten: Bei der Merchant API wird die Produktverwaltung in zwei Ressourcen aufgeteilt. Mit der Ressource ProductInput können Sie Ihre Produktdaten einfügen, aktualisieren und löschen. Mit der schreibgeschützten Product-Ressource können Sie das endgültige Produkt ansehen, nachdem Google Ihre Eingaben verarbeitet, Regeln angewendet und Daten aus zusätzlichen Quellen kombiniert hat.

  • Codierung für Produktnamen: Sie können die unpadded base64url-Codierung (RFC 4648, Abschnitt 5) für die Felder ProductInput.name und Product.name verwenden. Wenn die Produktnamen Zeichen enthalten, die von der Merchant API oder von URL-reservierten Zeichen verwendet werden, ist die Codierung erforderlich. Sie müssen beispielsweise die Produktnamen codieren, wenn sie eines der folgenden Zeichen enthalten:

    % . + / : ~ , ( * ! ) & ? = @ # $

  • Status des integrierten Produkts: Der Dienst productstatuses wird entfernt. Probleme bei der Produktvalidierung und Zielstatus sind jetzt direkt in der Product-Ressource im Feld productStatus enthalten, was den Datenabruf vereinfacht.

  • Vorhersehbare Produktupdates: Mit der neuen Methode productInputs.patch wird eine bestimmte Produkteingabe direkt geändert. Das ist eine deutliche Verbesserung gegenüber der Content API for Shopping, bei der Aktualisierungen unerwartet durch andere Feeduploads überschrieben werden konnten. In der Merchant API bleibt eine Aktualisierung erhalten, bis die entsprechende Produkteingabe noch einmal aktualisiert oder gelöscht wird. Produktaktualisierungen werden auf die Ressource ProductInput angewendet und nicht auf die verarbeitete Ressource Product.

  • Datenquelle für eine übersichtlichere Datenverwaltung auswählen: Für alle productInputs-Schreibvorgänge ist jetzt ein dataSource-Abfrageparameter erforderlich. So wird explizit angegeben, welche Datenquelle Sie ändern. Das ist besonders nützlich, wenn Sie Daten aus mehreren Quellen beziehen.

  • Neue Ressourcen-IDs: Produkte werden jetzt durch eine RESTful-Ressource name anstelle des Felds id identifiziert. Das Format dafür ist accounts/{account}/products/{product}.

  • Keine benutzerdefinierten Batches: Die Methode custombatch ist nicht mehr verfügbar. Sie können asynchrone Anfragen oder HTTP-Batching verwenden, um mehrere Anfragen in einem einzelnen HTTP-Aufruf zu senden.

  • Datenquellen für beliebige Feedlabels und Sprachen: Mit der Merchant API können Sie Datenquellen erstellen, ohne Feedlabel und Sprache anzugeben. So lassen sich Produkte mit beliebigen Feedlabels und Sprachen einfügen.

Anfragen

In diesem Abschnitt werden die Anfrageformate für die Content API for Shopping und die Merchant API verglichen.

Beschreibung der Anfrage Content API for Shopping Merchant API
Produkt kaufen GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product}
Produkte auflisten GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products
Produkt einfügen POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products POST https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs:insert
Produkt aktualisieren PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} PATCH https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput}
Produkt löschen DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} DELETE https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput}
Produktstatus abrufen GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses/{productId} GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product}
Produktstatus auflisten GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products
Mehrere Anfragen in einem Batch zusammenfassen POST https://shoppingcontent.googleapis.com/content/v2.1/products/custombatch Asynchrone Anfragen oder HTTP-Batching verwenden

IDs

Das Format für Produkt-IDs wurde in der Merchant API in einen standardmäßigen REST-Ressourcennamen geändert.

Beschreibung der Kennung Content API for Shopping Merchant API
Produkt-ID Ein String, der aus durch einen Doppelpunkt (:) getrennten Segmenten besteht.
Format: channel:contentLanguage:targetCountry:offerId oder channel:contentLanguage:feedLabel:offerId.
Beispiel: online:en:US:sku123		 Ein REST-Ressourcenstring name
.Format: accounts/{account}/products/{product}, wobei {product} contentLanguage~feedLabel~offerId ist.
Beispiel: accounts/12345/products/en~US~sku123.
Codierung: Base64url-Codierung ohne Auffüllung empfohlen und erforderlich bei Produkt-IDs, die von der Merchant API verwendete Zeichen oder URL-reservierte Zeichen enthalten.

Methoden

In dieser Tabelle finden Sie die Content API for Shopping-Methoden und ihre Entsprechungen in der Merchant API.

Content API for Shopping-Methode Merchant API-Methode Verfügbarkeit und Hinweise
products.get products.get Ruft das endgültige, verarbeitete Produkt ab.
products.list products.list Listet die endgültigen, verarbeiteten Produkte auf.
products.insert productInputs.insert Fügt eine Produkteingabe ein. Erfordert einen dataSource.
products.update productInputs.update Das Verhalten ist deutlich anders. Damit wird eine bestimmte Produkteingabe aktualisiert. Die Änderung ist dauerhaft.
products.delete productInputs.delete Löscht eine bestimmte Produkteingabe. Erfordert einen dataSource.
products.custombatch Nicht verfügbar Verwenden Sie asynchrone Anfragen oder HTTP-Batching.
productstatuses.get products.get Der Dienst productstatuses wird entfernt. Statusinformationen sind jetzt Teil der Product-Ressource.
productstatuses.list products.list Der Dienst productstatuses wird entfernt. Statusinformationen sind jetzt Teil der Product-Ressource.
productstatuses.custombatch Nicht verfügbar Verwenden Sie asynchrone Anfragen oder HTTP-Batching.

Detaillierte Feldänderungen

In dieser Tabelle werden wichtige Felder hervorgehoben, die in der Merchant API geändert, hinzugefügt oder entfernt wurden.

Content API for Shopping Merchant API Beschreibung
id name Die primäre Kennung für ein Produkt ist jetzt die REST-Ressource name. Base64url-Codierung ohne Auffüllung wird empfohlen und ist erforderlich, wenn Produktnamen Zeichen enthalten, die von der Merchant API verwendet werden, oder URL-reservierte Zeichen.
Attribute der Produktdatenspezifikation auf oberster Ebene (z.B. title, price, link) productAttributes Objekt Produktattribute wie title, price und link sind nicht mehr Felder der obersten Ebene. Sie sind jetzt sowohl in den Ressourcen Product als auch ProductInput im Objekt productAttributes gruppiert. So erhalten Sie eine übersichtlichere und besser organisierte Ressourcenstruktur.
targetCountry feedLabel Der Ressourcenname verwendet jetzt feedLabel anstelle von targetCountry, um der Merchant Center-Funktionalität zu entsprechen.
feedId dataSource (Abfrageparameter) Der Name dataSource ist jetzt ein erforderlicher Abfrageparameter für alle productInputs-Schreibmethoden (insert, update, delete).
channel Nicht verfügbar. Verwenden Sie legacy_local nur für lokal erhältliche Produkte. Das Feld „channel“ ist in der Merchant API nicht mehr vorhanden. Bei Produkten mit dem Kanal LOCAL in der Content API for Shopping sollte stattdessen das Feld legacy_local auf „true“ gesetzt werden.
Nicht verfügbar versionNumber Ein neues optionales Feld für ProductInput, mit dem verhindert werden kann, dass Daten in primäre Datenquellen in falscher Reihenfolge eingefügt werden.
string-Typfelder mit definiertem Satz von Werten enum-Typfelder mit definiertem Satz von Werten Felder in Produktattributen mit einem definierten Satz von Werten (z. B. excluded_destinations, availability) haben jetzt den Typ enum.
Zurück
Migrate merchant support
Weiter
Migrate data sources management