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} |