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, einschließlich Produktstatus und Problemen. Diese neue Struktur sorgt für eine vorhersehbarere und transparentere Nutzung.
In diesem Leitfaden werden die wichtigsten Unterschiede erläutert, um Ihnen die Migration Ihrer Integration von der Content API for Shopping zu erleichtern. Eine detaillierte Anleitung zur Verwendung der neuen Funktionen finden Sie unter Produkte verwalten.
Wichtige Unterschiede
Hier sind die wichtigsten Änderungen bei der Verwaltung von Produkten in der Merchant API im Vergleich zur Content API for Shopping:
Dedizierte Ressourcen für Eingabe- und verarbeitete Daten: Die Merchant API teilt die Produktverwaltung in zwei Ressourcen auf. Sie können die Ressource
ProductInputverwenden, um Ihre Produktdaten einzufügen, zu aktualisieren und zu löschen. Mit der RessourceProductmit Lesezugriff können Sie sich das Endprodukt ansehen, nachdem Google Ihre Eingaben verarbeitet, Regeln angewendet und Daten aus zusätzlichen Quellen kombiniert hat.Codierung für Produktnamen: Sie können die ungepaddete base64url-Codierung (RFC 4648, Abschnitt 5) für die Felder
ProductInput.nameundProduct.nameverwenden. Wenn die Produktnamen Zeichen enthalten, die von der Merchant API verwendet werden, oder für URLs reservierte Zeichen, ist die Codierung erforderlich. Sie müssen beispielsweise die Produktnamen codieren, wenn sie eines der folgenden Zeichen enthalten:% . + / : ~ , ( * ! ) & ? = @ # $Status des integrierten Produkts: Der
productstatuses-Dienst wird entfernt. Probleme bei der Produktvalidierung und Zielstatus werden jetzt direkt in die RessourceProductim FeldproductStatusaufgenommen, was den Datenabruf vereinfacht.Vorhersehbare Produktupdates: Mit der neuen Methode
productInputs.patchwird eine bestimmte Produkteingabe direkt geändert. Dies ist eine erhebliche 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 so lange bestehen, bis die entsprechende Produkteingabe noch einmal aktualisiert oder gelöscht wird. Produktaktualisierungen werden auf die RessourceProductInputund nicht auf die verarbeitete RessourceProductangewendet.Datenquelle für ein übersichtlicheres Datenmanagement auswählen: Für alle
productInputs-Schreibvorgänge ist jetzt eindataSource-Abfrageparameter erforderlich. So ist klar, welche Datenquelle Sie ändern. Das ist besonders nützlich, wenn Sie Daten aus mehreren Quellen haben.Neue Ressourcenkennungen: Produkte werden jetzt durch eine RESTful-Ressource
nameanstelle des Feldsididentifiziert. Das Format istaccounts/{account}/products/{product}.Keine benutzerdefinierten Batches: Die Methode
custombatchist nicht mehr verfügbar. Sie können asynchrone Anfragen oder HTTP-Batches verwenden, um mehrere Anfragen in einem einzigen HTTP-Aufruf zu senden.
Richtlinien für Datenquellen während der Migration
Bevor Sie Ihre Datenquellen migrieren, sollten Sie unbedingt eine Datenquellenstrategie auswählen.
Beachten Sie die folgenden Empfehlungen, um eine reibungslose Migration zu gewährleisten und Probleme wie das Stehlen von Angeboten zu vermeiden:
Datenbank füllen: Anstatt vor jedem Produktvorgang
dataSources.listaufzurufen, empfehlen wir dringend, Ihre lokale Datenbank einmalig zu füllen. Fügen Sie jedem Produkteintrag eindataSource-Namensfeld hinzu, damit Sie die richtige Kennzeichnung direkt in Ihren Anfragen angeben können.Datenquellen für beliebige Labels und Sprachen zusammenführen und verwenden: Mit der Merchant API können Sie eine Datenquelle erstellen, ohne Label und Sprache anzugeben. So können Sie Produkte mit beliebigen Datenquellenlabels und ‑sprachen einfügen. Verwenden Sie am besten eine einzige Datenquelle für alle Labels und Sprachen.
Produkte schützen: Wenn Sie Datenquellenregeln verwenden, rufen Sie
products.getauf, um die genauedataSourcezu ermitteln, die mit einem Produkt verknüpft ist, bevor Sie es aktualisieren oder löschen. So wird sichergestellt, dass Sie die gewünschte Quelle ändern, und ein versehentliches Übernehmen von Angeboten wird verhindert.
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 im Batch senden | POST https://shoppingcontent.googleapis.com/content/v2.1/products/custombatch |
Asynchrone Anfragen oder HTTP-Batches verwenden |
IDs
Das Format für Produktkennzeichnungen wurde in der Merchant API in einen Standard-REST-Ressourcennamen geändert.
| Beschreibung der ID | Content API for Shopping | Merchant API |
|---|---|---|
| Produkt-ID | Ein String, der aus Segmenten besteht, die durch einen Doppelpunkt (:) getrennt sind.Format: channel:contentLanguage:targetCountry:offerId oder channel:contentLanguage:feedLabel:offerId.Beispiel: online:en:US:sku123 |
Ein REST-Ressourcen-name-String.Format: accounts/{account}/products/{product}, wobei {product} contentLanguage~feedLabel~offerId ist.Beispiel: accounts/12345/products/en~US~sku123.Codierung: Ungepaddete base64url-Codierung empfohlen und erforderlich bei Produkt-IDs, die von der Merchant API verwendete Zeichen oder URL-reservierte Zeichen enthalten. |
Methoden
In dieser Tabelle sind die Content API for Shopping-Methoden und ihre Entsprechungen in der Merchant API aufgeführt.
| 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 endgültige, verarbeitete Produkte auf. |
products.insert |
productInputs.insert |
Fügt eine Produkteingabe ein. Erfordert einen dataSource. |
products.update |
productInputs.patch |
Das Verhalten ist deutlich anders. Sie aktualisiert eine bestimmte Produkteingabe und 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-Batches. |
productstatuses.get |
products.get |
Der Dienst productstatuses wird entfernt. Statusinformationen sind jetzt Teil der Ressource Product. |
productstatuses.list |
products.list |
Der Dienst productstatuses wird entfernt. Statusinformationen sind jetzt Teil der Ressource Product. |
productstatuses.custombatch |
Nicht verfügbar | Verwenden Sie asynchrone Anfragen oder HTTP-Batches. |
Detaillierte Feldänderungen
In dieser Tabelle sind wichtige Felder aufgeführt, 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. Ungepolsterte base64url-Codierung 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 keine Felder auf oberster Ebene mehr. Sie sind jetzt sowohl in der Product- als auch in der ProductInput-Ressource im productAttributes-Objekt 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 (Suchparameter) |
Ein dataSource-Name ist jetzt ein erforderlicher Suchparameter für alle productInputs-Schreibmethoden (insert, update, delete). |
channel |
Nicht verfügbar. Verwenden Sie legacy_local für Produkte, die nur lokal erhältlich sind. |
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 in ProductInput, mit dem verhindert werden kann, dass Einfügungen in primäre Datenquellen in der falschen Reihenfolge erfolgen. |
string-Typfelder mit definierten Werten |
enum-Typfelder mit definierten Werten |
Felder innerhalb von Produktattributen mit einem definierten Satz von Werten (z. B. excluded_destinations, availability) sind jetzt vom Typ enum. |
gtin |
productAttributes.gtins |
Von einem einzelnen String (gtin) in einen wiederholten String (gtins) geändert. |
sizes |
productAttributes.size |
Wurde von einem wiederholten String (sizes) in einen einzelnen String (size) geändert. |
sizeType, additionalSizeType |
productAttributes.sizeTypes |
sizeType und additionalSizeType wurden durch ein wiederholtes SizeType-Enum (sizeTypes) ersetzt, das bis zu zwei Werte akzeptiert (z. B. ["PETITE", "MATERNITY"]). |