- Die Merchant API ist seit Juli 2025 allgemein verfügbar. Die Content API for Shopping hat am 18. August 2026 ihr Laufzeitende erreicht, seit dem 1. September 2026 schlagen Anfragen zunehmend fehl.
- Statt eines Feeds, den Google zu festen Zeiten abholt, sendet Ihr System Änderungen an Preis und Bestand sofort an Google. Abgelehnte Produkte wegen Preisabweichungen werden seltener.
- Die Merchant API ist modular aufgebaut, arbeitet mit Datenquellen und kennt kein customBatch mehr. Teilaktualisierungen laufen über patch.
- Den größten Gewinnhebel liefern Margen-Labels, die per API täglich aktuell bleiben und die Gebote auf die Produkte lenken, an denen Sie verdienen.
Ein Szenario aus der Hochsaison: Am Black Friday senken Sie um 14 Uhr den Preis Ihres meistverkauften Produkts um 20 %, um mit einem Wettbewerber gleichzuziehen. Der Shop zeigt den neuen Preis sofort. Der Produktfeed für Google Shopping wird aber erst nachts um 3 Uhr aktualisiert. Google prüft die Landingpage, stellt eine Abweichung zwischen Anzeigenpreis und Shoppreis fest und lehnt das Produkt ab, ausgerechnet in der umsatzstärksten Zeit des Jahres. Oder das Produkt wird weiter beworben, obwohl das Lager leer ist. Das führt zu Stornierungen, schlechten Bewertungen und bei wiederholten Abweichungen im Extremfall zur Sperrung des Merchant Centers.
Die Lösung für dieses Zeitproblem ist die Merchant API von Google. Sie ist die offizielle Nachfolgerin der Content API for Shopping und ermöglicht den Wechsel von einer Aktualisierung pro Tag zu einer Steuerung in Echtzeit. In diesem Leitfaden zeigen wir, wie die Merchant API aufgebaut ist, wie die technische Anbindung funktioniert und mit welchen Anwendungsfällen sie sich wirtschaftlich auszahlt.
Die Content API for Shopping ist abgeschaltet, die Merchant API ist der neue Standard
Google hat die Merchant API (v1) im Juli 2025 allgemein verfügbar gemacht. Die Vorabversion v1beta wurde am 28. Februar 2026 eingestellt. Die Content API for Shopping hat am 18. August 2026 ihr Laufzeitende erreicht. Seit dem 1. September 2026 schlagen Anfragen an die alte API zunehmend fehl. Wer mehr Zeit braucht, kann bei Google eine Verlängerung beantragen.
Für Sie heißt das: Jedes Shop-Plugin, jedes Repricing-Tool und jedes eigene Skript, das noch die Content API aufruft, ist ein Risiko für Ihre Shopping-Kampagnen. Dateibasierte Feeds als CSV oder XML sind davon nicht betroffen. Sie bleiben als Datenquelle im Merchant Center weiter möglich.
Ihre Produktdaten werden zu einem Strom von Ereignissen
Viele betrachten Produktdaten als Datei, die irgendwo auf einem Server liegt und abgeholt wird. Die API ändert diese Sicht: Produktdaten sind kein Zustand, sondern eine Folge von Ereignissen.
Der klassische Feed folgt dem Pull-Prinzip. Google holt die Daten zu festen Zeiten ab. Ändern Sie um 10 Uhr einen Preis und kommt der Abruf erst um 16 Uhr, sind Anzeigen und Shop sechs Stunden lang nicht synchron.
Die Merchant API folgt dem Push-Prinzip. Ihr System, also Shop, Warenwirtschaft oder Produktinformationssystem (PIM), sendet die Änderung aktiv an Google, sobald sie eintritt. Bestand ändert sich, Preis ändert sich, Titel wird optimiert: Jedes Mal geht eine Anfrage an Google. Die Verzögerung sinkt von Stunden auf Minuten.
| Merkmal | Statischer Feed (XML/CSV) | Merchant API |
|---|---|---|
| Übertragung | zeitgesteuert, etwa einmal täglich | ereignisgesteuert |
| Richtung | Google holt die Daten (Pull) | Ihr System sendet die Daten (Push) |
| Fehlererkennung | verzögert, beim nächsten Abruf | sofort, in der Antwort auf die Anfrage |
| Granularität | oft muss die ganze Datei neu geladen werden | einzelne Attribute wie der Preis lassen sich ändern |
| Aufwand | gering, Export-Datei erstellen | hoch, Entwicklung und Wartung nötig |
| Skalierung | begrenzt durch Dateigröße und Verarbeitungsdauer | hoch, begrenzt durch die Kontingente der API |
Die Merchant API ist modular und arbeitet mit Datenquellen
Google hat die API neu geordnet. Statt eines einzigen Endpunkts gibt es eigene Teil-APIs, unter anderem für Produkte, Inventare, Datenquellen, Konten, Berichte und Benachrichtigungen. Die Adressen folgen dem Muster merchantapi.googleapis.com/{Teil-API}/{Version}/{Ressource}. Statt einzelner IDs arbeitet die API mit einem Namensfeld, etwa accounts/123/products/de~DE~SKU-1001.
Primäre und ergänzende Datenquellen trennen Stammdaten von Preis und Bestand
Der wichtigste Begriff ist die Datenquelle. Statt eines großen Hauptfeeds, der alles enthält, schichten Sie mehrere Quellen übereinander:
- Primäre Datenquelle: der Basisdatensatz mit Daten, die sich selten ändern, also ID, Titel, Beschreibung, Bild-URL und GTIN. Er kommt oft aus dem PIM.
- Ergänzende Datenquelle: eine zusätzliche Quelle, die nur Preis und Bestand enthält und per API sehr häufig aktualisiert wird.
Der Vorteil: Ihr PIM muss nicht alle zehn Minuten einen Vollexport erzeugen, was oft gar nicht möglich ist. Ein schlankes Skript erkennt Preisänderungen in Warenwirtschaft oder Shop und überträgt nur diese. Google führt die Daten im Merchant Center zusammen. Wichtig: Per API einfügen lassen sich Produkte nur in Datenquellen vom Typ „API“. Diese Datenquelle legen Sie vor dem ersten Upload an.
Daneben kennt die Merchant API eigene Datenquellen für lokales und regionales Inventar, Aktionen und Bewertungen.
Konten und Unterkonten lassen sich per API verwalten
Für Unternehmen mit mehreren Marken oder Ländershops ist die Kontostruktur entscheidend. Über die Accounts-Teil-API legen Sie Unterkonten für neue Länder oder Marken an, vergeben Nutzerrechte und konfigurieren Einstellungen wie Zeitzone, Sprache und Versand. Statt sich bei 50 Ländershops durch die Oberfläche zu klicken, richtet ein gut geschriebenes Skript die Struktur in kurzer Zeit fehlerfrei ein und verknüpft das Google-Ads-Konto.
Die API meldet Fehler sofort, damit Sie handeln, bevor Umsatz verloren geht
Einer der unterschätzten Vorteile ist nicht das Senden, sondern das Empfangen von Rückmeldungen. Beim klassischen Feed läuft es oft so: Upload am Morgen, am Nachmittag fällt im Merchant Center auf, dass 500 Artikel wegen fehlerhafter Bild-URLs abgelehnt wurden, dann beginnt die Fehlersuche.
Mit der Merchant API kehren wir diesen Ablauf um:
- Sofortige Fehlermeldungen: Ist ein Datensatz formal falsch, etwa mit ungültigem Datum oder fehlender Währung, sagt die API das direkt in der Antwort. Seit 2026 liefert sie dafür auch maschinenlesbare Fehlerinformationen. Ihre Middleware kann den Fehler selbst korrigieren oder das Team sofort informieren.
- Benachrichtigungen bei Statusänderungen: Verstöße gegen Richtlinien stellt Google oft erst nach der Prüfung fest. Die Merchant API bietet dafür Benachrichtigungen bei Änderungen an Produkt- und Kontodaten, die es in der Content API nicht gab. Den aktuellen Status jedes Produkts fragen Sie über die Products-Teil-API ab.
Daraus lässt sich ein Dashboard oder ein Hinweis im Teamchat bauen: „Zeige alle Produkte, die gestern aktiv waren und heute abgelehnt sind.“ So lösen Sie Probleme, bevor der Umsatz einbricht.
Das wirkt auch auf die Gebotssteuerung. Smart Bidding und Performance Max können nur Produkte bewerben, die freigegeben sind und deren Preis stimmt. Aktuelle Daten verhindern Ausfälle und Absprünge auf der Landingpage, weil Anzeigenpreis und Shoppreis übereinstimmen.
So binden Sie die Merchant API technisch an
Dieser Abschnitt richtet sich an Entwickler. Die Anbindung ist überschaubar, verlangt aber Sorgfalt bei Authentifizierung und Fehlerbehandlung. Ein schlecht geschriebenes Skript kann Kontingente schnell aufbrauchen oder falsche Preise live schalten.
Schritt 1: Google-Cloud-Projekt einrichten und registrieren
- Projekt anlegen: Erstellen Sie in der Google Cloud Console ein eigenes Projekt mit eindeutigem Namen und aktivieren Sie die Merchant API.
- Projekt registrieren: Neu ist die Entwicklerregistrierung. Sie verknüpft Ihr Merchant-Center-Konto mit dem Cloud-Projekt über den Aufruf
developerRegistration:registerGcp. - Dienstkonto anlegen: Für die Kommunikation von Server zu Server nutzen Sie ein Dienstkonto statt eines Logins mit Nutzerkonto. Laden Sie den JSON-Schlüssel herunter und bewahren Sie ihn sicher auf. Er gehört nie in ein öffentliches Repository.
- Zugriff erteilen: Fügen Sie die E-Mail-Adresse des Dienstkontos im Merchant Center unter „Personen und Zugriff“ als Nutzer hinzu. Ohne diesen Schritt lehnt die API jede Anfrage mit „403 Forbidden“ ab.
Schritt 2: Client-Bibliotheken nutzen
Bauen Sie die HTTP-Anfragen nicht selbst. Authentifizierung und Token-Verwaltung sind fehleranfällig. Google stellt Client-Bibliotheken für Python, Java, PHP und weitere Sprachen bereit. Für Python:
pip install google-shopping-merchant-products google-auth
Schritt 3: Produkte übertragen
Das Kernstück ist die Methode productInputs.insert. Sie legt ein Produkt in einer API-Datenquelle an oder ersetzt es, wenn es mit denselben Kennungen schon existiert. Ein vereinfachtes Beispiel nach dem Muster der offiziellen Google-Beispiele:
from google.oauth2 import service_account
from google.shopping import merchant_products_v1
from google.shopping.type import Price
KEY_FILE = 'pfad/zum/dienstkonto-schluessel.json'
ACCOUNT_ID = '123456789' # Ihre Merchant-Center-ID
DATA_SOURCE_ID = '987654321' # ID Ihrer API-Datenquelle
credentials = service_account.Credentials.from_service_account_file(
KEY_FILE, scopes=['https://www.googleapis.com/auth/content'])
client = merchant_products_v1.ProductInputsServiceClient(credentials=credentials)
product_input = merchant_products_v1.ProductInput(
offer_id='SKU-1001-BLUE',
content_language='de',
feed_label='DE',
product_attributes=merchant_products_v1.ProductAttributes(
title='Hoodie Navy Blue',
link='https://www.example.com/hoodie-blue',
image_link='https://www.example.com/images/hoodie-blue.jpg',
availability=merchant_products_v1.Availability.IN_STOCK,
condition=merchant_products_v1.Condition.NEW,
price=Price(amount_micros=49_990_000, currency_code='EUR'), # 49,99 EUR
),
)
request = merchant_products_v1.InsertProductInputRequest(
parent=f'accounts/{ACCOUNT_ID}',
data_source=f'accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}',
product_input=product_input,
)
try:
response = client.insert_product_input(request=request)
print(f'Produkt übermittelt: {response.name}')
except Exception as e:
print(f'Fehler beim Upload: {e}')
Zwei Unterschiede zur Content API fallen sofort auf: Preise stehen in Mikro-Einheiten (amount_micros, 49.990.000 entspricht 49,99), und jedes Produkt wird einer Datenquelle zugeordnet. Bis das fertige Produkt mit allen Prüfungen abrufbar ist, können einige Minuten vergehen.
Schritt 4: Preis und Bestand gezielt aktualisieren
Ein häufiger Fehler: Für eine Preisänderung wird der komplette Datensatz mit Beschreibung und Bildern neu gesendet. Die Merchant API bietet dafür die Methode patch, mit der Sie nur die geänderten Felder übertragen. Google hat 2026 zusätzlich schnellere Aktualisierungen von Preis und Verfügbarkeit über patch angekündigt, zunächst für freigeschaltete Händler. Für den Bestand je Filiale gibt es die Inventories-Teil-API mit lokalem und regionalem Inventar.
Trennen Sie deshalb sauber zwischen einer vollständigen Aktualisierung, wenn sich das Produkt grundlegend ändert, und einer Transaktionsaktualisierung, wenn sich nur Preis oder Bestand ändern.
Schritt 5: Viele Produkte parallel übertragen
Eine Anfrage pro Produkt nacheinander ist bei 50.000 Artikeln zu langsam. Die Content API löste das mit custombatch. Die Merchant API unterstützt custombatch nicht mehr. Stattdessen senden Sie mehrere Anfragen gleichzeitig oder arbeiten asynchron, etwa mit gRPC und einem Pool von Verbindungen. Werten Sie die Antwort jeder einzelnen Anfrage aus, damit Sie wissen, welches Produkt angekommen ist und welches nicht.
Schritt 6: Fehler abfangen und Kontingente respektieren
Google schützt seine Infrastruktur mit Kontingenten. Wer sie überschreitet, erhält meist „429 Too Many Requests“ oder „503 Service Unavailable“. Sofort neue Anfragen hinterherzuschicken, verschärft das Problem. Bewährt hat sich ein exponentielles Backoff:
- Anfrage schlägt fehl, 1 Sekunde warten, erneut versuchen.
- Schlägt wieder fehl, 2 Sekunden warten.
- Dann 4 Sekunden, dann 8 Sekunden.
Die Client-Bibliotheken bringen solche Wiederholungen teilweise mit. Ihre Skripte sollten trotzdem so robust sein, dass sie Netzwerkschwankungen überstehen, ohne abzubrechen.
Mit drei Anwendungsfällen machen wir aus Echtzeitdaten Gewinn
Technik ist Mittel zum Zweck. Dass Daten in Sekunden bei Google sind, nützt nur, wenn daraus ein wirtschaftlicher Vorteil entsteht.
Anwendungsfall A: Dynamische Preise ohne Ablehnungen
In umkämpften Märkten wie Elektronik oder Mode ändern sich Preise mehrmals täglich. Mit einem Feed entsteht ein Problem: Sie senken den Preis eines Laptops im Shop von 999 auf 899 Euro, der Feed läuft aber erst in sechs Stunden.
- Fall 1: Die Anzeige zeigt noch 999 Euro. Der Nutzer klickt, sieht 899 Euro und kauft. Sie haben aber für einen Klick bezahlt, der mit dem schlechteren Preis geworben hat.
- Fall 2: Sie erhöhen den Preis wieder. Die Anzeige zeigt 899 Euro, der Shop 999 Euro. Der Nutzer fühlt sich getäuscht und springt ab. Google bemerkt die Abweichung und lehnt das Produkt ab.
Mit der API löst die Preisänderung im Shop sofort eine Anfrage an Google aus. Anzeigen und Shop bleiben synchron, auch bei Aktionen über wenige Stunden.
Anwendungsfall B: Gebote nach Marge steuern
Die meisten Händler übergeben nur Verkaufspreise. Der größere Hebel liegt in benutzerdefinierten Labels für die Marge. Schwankt Ihr Einkaufspreis, ändert sich die Marge täglich, auch wenn der Verkaufspreis gleich bleibt. Mit einem statischen Feed ist es mühsam, ein Margen-Label aktuell zu halten.
Mit der API lässt sich eine einfache Logik bauen:
- Marge über 30 %: Label 0 auf „High_Margin“.
- Marge unter 10 %: Label 0 auf „Low_Margin“.
Die Änderung geht sofort an Google. Kampagnen, die nach diesen Labels getrennt sind, bieten stärker auf Produkte, die heute mehr Gewinn bringen, und ziehen Budget von Produkten ab, deren Einkaufspreis gestiegen ist. So können Sie Produktmargen bei der Steuerung Ihrer Shopping-Kampagnen berücksichtigen.
Anwendungsfall C: Lokaler Bestand und Abholung im Geschäft
Online kaufen und im Geschäft abholen funktioniert nur mit verlässlichen Bestandsdaten. Nichts frustriert mehr, als wegen „Auf Lager“ in die Filiale zu fahren und vor einem leeren Regal zu stehen. Über die Inventories-Teil-API aktualisieren Sie den Bestand je Filiale. Wird das letzte Paar Schuhe in München verkauft, meldet das Kassensystem den Bestand null, und die Anzeige „Verfügbar in München“ verschwindet. Sie sparen Klickkosten und vermeiden enttäuschte Kunden. Mehr dazu im Beitrag zu Local Inventory Ads.
Wir migrieren schrittweise und ohne Umsatzrisiko
Niemand sollte ein laufendes System von heute auf morgen umstellen. Das Risiko ist zu hoch. Bewährt hat sich ein schrittweiser Weg, der den bestehenden Feed als Sicherheitsnetz behält.
Phase 1: API als Ergänzung für Preis und Verfügbarkeit
Der bestehende XML-Feed bleibt primäre Datenquelle und liefert Titel, Beschreibungen, Bilder und GTINs. Per API übertragen Sie zunächst nur Preis und Verfügbarkeit in eine ergänzende Datenquelle.
- Fällt die API-Anbindung aus, hat Google weiterhin die Daten aus dem Feed. Sie sind dann einige Stunden alt, aber das Produkt verschwindet nicht.
- Das erste Projekt bleibt überschaubar, weil nur zwei Felder zugeordnet werden müssen.
Phase 2: Inhalte per API optimieren
Läuft Phase 1 stabil, aktualisieren Sie auch Titel und Beschreibungen per API. Das ist besonders für Teams interessant, die Titel testen wollen, ohne auf einen neuen Feed-Export der IT zu warten.
Phase 3: API zuerst
Der XML-Feed wird abgeschaltet oder dient nur noch als Notfall-Reserve. Ihr PIM oder Shop ist die einzige verbindliche Datenquelle und spricht direkt mit Google.
Wer noch Prozesse auf der Content API betreibt, hat diesen Spielraum nicht mehr. Hier gilt: zuerst die bestehenden Aufrufe auf die Merchant API umstellen, danach ausbauen.
Produktdaten sind auch die Grundlage für die KI-Suche
Google sagt im Leitfaden für die generative Suche, dass KI-Antworten Produktangebote und Produktinformationen enthalten können und dass Merchant-Center-Daten helfen, damit Produkte dort und in den übrigen Suchergebnissen erscheinen. Vollständige und aktuelle Produktdaten sind damit für die Sichtbarkeit im KI-Modus ebenso wichtig wie für Anzeigen.
Google baut die Merchant API dafür weiter aus. 2026 kamen unter anderem Attribute für Produktinformationen in Gesprächsform, Einstellungen für den Checkout direkt in Googles KI-Oberflächen über das Universal Commerce Protocol (UCP) und ein erster, nur lesender Zugang für KI-Assistenten über das Model Context Protocol dazu. Wie das Universal Commerce Protocol funktioniert, beschreiben wir im Beitrag zu Google UCP.
Fazit: Wer seine Produktdaten automatisiert, steuert schneller auf Gewinn
Die Merchant API ist Infrastruktur für jeden Onlinehändler, der wachsen will. Mit dem Ende der Content API ist sie für alle, die Produktdaten per Schnittstelle übertragen, ohnehin Pflicht.
Im Wettbewerb bieten zunehmend Algorithmen gegen Algorithmen: Ihr Repricing gegen das des Wettbewerbers, Ihr Smart Bidding gegen alle anderen. Diese Systeme sind nur so gut wie die Daten, die sie bekommen. Je aktueller und genauer Preise, Bestände und Margen-Labels sind, desto besser die Entscheidungen. Ein Feed von letzter Nacht ist wie die Zeitung von gestern: informativ, aber für schnelle Entscheidungen zu spät.



