Produktverwaltung migrieren

Mit der Merchant API können Sie Ihre Produkte programmatisch hochladen und verwalten. Mit der Ressource accounts.products können Sie einen Onlineshopkatalog erstellen, also eine Liste von Produkten und Angeboten. Weitere Informationen zum Hochladen und Verwalten Ihrer Produkte mit der Merchant API finden Sie unter Merchant Products API.

Ressourcenänderungen

Die Ressourcen products und productstatuses der Content API werden durch die Ressourcen productInputs und products ersetzt.

Sie können die productInputs-Ressource der Merchant API verwenden, um Ihre Produktinformationen hochzuladen. Mit der product-Ressource der Merchant API können Sie Ihre verarbeiteten Produkte einschließlich Status abrufen.

Anforderung an die Datenquelle

In der Merchant API müssen Sie beim Hochladen von Produkten die Zieldatenquelle angeben. Das kann eine primäre oder eine ergänzende Datenquelle sein. Sie können Ihre vorhandenen Datenquellen mit dataSources.list abrufen oder mit dataSources.create eine neue Datenquelle erstellen.

Alternativ können Sie Ihre Datenquellen über die Merchant Center-Benutzeroberfläche verwalten.

Weitere Informationen zu Datenquellen und deren Erstellung und Verwaltung finden Sie unter Übersicht über die Merchant Data Sources API.

Änderungen an IDs

In der Merchant API wird das Produkt mit dem Attribut name identifiziert. Der Name des Produkts hat das Format accounts/{account}/products/{product}, wobei {product} das Format channel~language~feedLabel~offerId hat.

Bei Content API-Ressourcen wurde zwischen den einzelnen Werten in der ID : anstelle von ~ verwendet: channel:language:feedLabel:offerId.

Alle Merchant API-Aufrufe geben das neue Format mit ~ zwischen den Werten der ID zurück. Wir empfehlen, das neue Feld name aus der Antwort zu speichern und in zukünftigen Aufrufen zu verwenden.

Methoden

Hier ist ein Vergleich der „products“-Methoden in der Content API for Shopping und der Merchant Products API:

Content API for Shopping Merchant Products API
products.custombatch Nicht verfügbar
products.insert productInputs.insert
products.update Noch nicht verfügbar
products.delete productInputs.delete
products.get products.get
products.list products.list
productstatuses.custombatch Nicht verfügbar
productstatuses.get products.get
productstatuses.list products.list

Anfragen

Content API-Methode URL in der Content API for Shopping URL in der Merchant Products API Kennung in der Content API Kennung in der Merchant Products API
products.insert POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products POST https://merchantapi.googleapis.com/products/v1beta/{PARENT}/productsInputs:insert?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID} MERCHANT_ID PARENT=accounts/{MERCHANT_ID}
products.update PATCH https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} Nicht verfügbar
products.delete DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} DELETE https://merchantapi.googleapis.com/products/v1beta/{NAME}?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID} MERCHANT_ID, PRODUCT_ID NAME=accounts/{MERCHANT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES}
products.get GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} GET https://merchantapi.googleapis.com/products/v1beta/{NAME} MERCHANT_ID, PRODUCT_ID NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES}
products.list GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products MERCHANT_ID PARENT=accounts/{MERCHANT_ID}
productstatuses.get GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses/{PRODUCT_ID} GET https://merchantapi.googleapis.com/products/v1beta/{NAME} MERCHANT_ID, PRODUCT_ID NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES}
productstatuses.list GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products MERCHANT_ID PARENT=accounts/{MERCHANT_ID}