NeuProduct Score, 4T Segmentation, Price War und Broken Size sind live.Neuigkeiten ansehen
Feedance
Artikel

Content API 410-Fehler beheben: So migrieren Sie Ihre Feed-Pipeline auf die Merchant API

Die Content API for Shopping liefert 410-Fehler. So finden Sie verbliebene Aufrufe, ordnen sie der Merchant API zu und prüfen Ihre Produkte in Merchant Center.

Cagdas PolatCagdas Polat
9 Min. Lesezeit
Content API 410-Fehler beheben: So migrieren Sie Ihre Feed-Pipeline auf die Merchant API

Die Content API for Shopping von Google wurde am 18. August 2026 eingestellt. Seit dem 1. September schlagen Anfragen von Projekten ohne genehmigte Verlängerung sporadisch mit HTTP 410 fehl, und Anfang 2027 werden die Endpunkte vollständig abgeschaltet (Googles Einstellungshinweis). Wenn ein Skript, ein Plugin oder ein selbst entwickelter Connector Ihre Produkte noch über die alte API an Merchant Center überträgt, gehen einige dieser Updates bereits verloren.

Dieser Leitfaden richtet sich an Entwickler und Feed-Verantwortliche, die diese Pipeline selbst betreuen. Am Ende können Sie jeden verbliebenen Content-API-Aufruf finden, ihm sein Merchant-API-Gegenstück zuordnen, die Datenquelle anlegen, die die neue API voraussetzt, und in Merchant Center bestätigen, dass Produkte und Preise weiterhin ankommen.

So erkennen Sie, ob Sie von der Einstellung betroffen sind

Der Fehler wird leicht übersehen, weil er nur sporadisch auftritt. Google dokumentiert den Fehler-Body als 410 mit einer Meldung, die mit "Content API for Shopping was sunset on August 18, 2026" beginnt und Ihre Google-Cloud-Projekt-ID, die Projektnummer sowie einen Link zur Hilfe enthält. Durchsuchen Sie Ihre Integrationslogs nach diesem String und nach shoppingcontent.googleapis.com.

Drei Symptome zeigen sich meist, bevor jemand ein Log liest:

  • Preis- oder Verfügbarkeitsänderungen erreichen Google Stunden zu spät oder nur bei manchen Läufen.
  • Ein täglicher Job meldet bei den meisten Batches Erfolg und schlägt bei einigen fehl.
  • Merchant Center zeigt veraltete Daten, während Ihr Shop den korrekten Preis anzeigt.

Das letzte Symptom kann noch eine zweite Ursache haben: Googles eigene automatische Artikelaktualisierungen, die Ihre Werte überschreiben. Das behandeln wir separat im Artikel So verhindern Sie, dass Google Preis und Verfügbarkeit in Ihrem Feed stillschweigend überschreibt. Schließen Sie zuerst die 410-Fehler aus, denn sie lassen sich einfacher bestätigen.

Schritt 1: Alle Aufrufer der alten API erfassen

Google selbst empfiehlt, den Anwendungscode auf direkte Aufrufe von Content-API-Endpunkten zu prüfen. In der Praxis verstecken sich die Aufrufe an vier Stellen: im Google-Plugin der Shop-Plattform, in einem eigenen Skript eines früheren Entwicklers, in einer Feed- oder ERP-Middleware und in einem Google-Ads-Skript oder Apps Script, das jemand vor Jahren eingeplant hat.

Legen Sie ein kurzes Verzeichnis mit einer Zeile pro Aufrufer an. Halten Sie fest, was er tut, mit welchem Google-Cloud-Projekt er sich authentifiziert und wer dafür verantwortlich ist. Die Projekt-ID ist wichtig, weil Verlängerungen und die 410-Meldung daran gebunden sind.

AufruferWas er sendetVerantwortlichMaßnahme
Shop-PluginGesamter Katalog, täglichPlattformanbieterNachfragen, welche API-Version es aktuell nutzt
BestandsskriptPreis und Bestand, stündlichIhr EntwicklerAuf Merchant API migrieren
Feed-Management-ToolOptimierter FeedTool-AnbieterSchriftliche Bestätigung der Migration anfordern

Wenn ein Anbieter die Verbindung verwaltet, ist Ihre Aufgabe nachzufragen, nicht neu zu bauen. Productsup und Feedonomics haben beide Beschreibungen ihrer Migration veröffentlicht, und ein etablierter Anbieter wird bereits umgestellt haben. Stellen Sie jedem Anbieter auf Ihrer Liste dieselbe Frage und bewahren Sie die Antworten auf.

Schritt 2: Entscheiden, ob Sie eine Verlängerung brauchen

Google bietet ein Formular für Verlängerungsanträge der Content API für Organisationen, die mehr Zeit benötigen. Genehmigte Verlängerungen schützen ein Projekt für den genehmigten Zeitraum vor den geplanten Fehlerantworten, reichen aber nicht über die endgültige Abschaltung Anfang 2027 hinaus. Google gibt nicht an, wer dafür infrage kommt.

Verwenden Sie diese Entscheidungsregel: Wenn sich jeder Aufrufer innerhalb weniger Wochen migrieren und testen lässt, verzichten Sie auf die Verlängerung und investieren die Zeit in die Migration. Gehört ein Aufrufer zu einem Anbieter, der eine Migration zwar bestätigt, aber noch nicht terminiert hat, beantragen Sie eine Verlängerung nur für dieses Projekt. Eine Verlängerung ist ein Puffer, kein Plan.

Schritt 3: Jeden Aufruf seinem Merchant-API-Gegenstück zuordnen

Die Merchant API teilt den alten Monolithen in Sub-APIs auf und versioniert die URL (/products/v1/). Version v1 ist seit Juli 2025 allgemein verfügbar, und v1beta wurde am 28. Februar 2026 eingestellt. Entwickeln Sie daher gegen v1 und ignorieren Sie alle v1beta-Tutorials, auf die Sie stoßen (Release Notes der Merchant API).

Content APIMerchant APIWas sich ändert
products.insertproductInputs.insertErfordert einen Query-Parameter dataSource
products.updateproductInputs.patchDauerhafte Aktualisierung eines einzelnen Product Inputs
products.deleteproductInputs.deleteErfordert einen Parameter dataSource
products.get / listproducts.get / listGibt das verarbeitete Produkt zurück, nur lesend
productstatuses.get / listproducts.get / listDer Status ist jetzt Teil der Product-Ressource
custombatchParallele asynchrone AufrufeEs gibt keine customBatch-Methode
datafeedsdataSourcesJede Datenquelle zielt auf genau ein Feed-Label und eine Sprache

Quelle: Googles Migrationszuordnung für Produkte und Zuordnung für Datenquellen. Der konzeptionelle Wandel liegt in der Trennung zwischen einem ProductInput, also den Rohdaten, die Sie schreiben, und einem Product, dem verarbeiteten Ergebnis, das Sie nur lesen können. Ein verarbeitetes Produkt entsteht aus einem primären Input plus etwaigen ergänzenden Inputs, nachdem die Feed-Regeln angewendet wurden (Produktübersicht).

Schritt 4: Die API-Datenquelle anlegen, bevor Sie etwas einfügen

An diesem Schritt scheitern die meisten ersten Migrationen. Die Content API hat beim ersten Insert automatisch eine Datenquelle „Content API“ angelegt. Die Merchant API tut das nicht. Google stellt klar, dass Sie mindestens eine Datenquelle vom Typ API anlegen müssen und dass die Products-Sub-API nur in Datenquellen dieses Typs schreiben kann (Migration der Datenquellen).

Jede Datenquelle entspricht nun genau einer Kombination aus feedLabel und contentLanguage. Wenn Sie bisher die Türkei auf Türkisch und die VAE auf Englisch aus einem einzigen Multi-Target-Feed bedient haben, benötigen Sie jetzt separate Datenquellen. Legen Sie diese über die Data-Sources-Sub-API oder in Merchant Center an und verwenden Sie den resultierenden Ressourcennamen im Format accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} bei jedem Schreibvorgang.

Schritt 5: Den Payload umschreiben – mit einem durchgerechneten Beispiel

Drei Feldänderungen verursachen die meisten Fehler. Der Preis wechselt von einem Dezimal-String zu ganzzahligen Micros, wobei eine Million Micros einer Währungseinheit entsprechen. Produktattribute wandern in ein Objekt productAttributes. Und targetCountry wird durch feedLabel ersetzt, während channel wegfällt.

Die alte Produktkennung sah so aus; die neue verwendet Tilden und lässt den Kanal weg:

Content API:  online:en:US:SKU12345
Merchant API: en~US~SKU12345

Ein Product Input, den Googles eigener Leitfaden als Beispiel verwendet, sieht so aus (Insert mit POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}):

{
  "offerId": "SKU12345",
  "contentLanguage": "en",
  "feedLabel": "US",
  "productAttributes": {
    "title": "Classic Cotton T-Shirt",
    "link": "https://www.example.com/p/SKU12345",
    "imageLink": "https://www.example.com/img/SKU12345.jpg",
    "availability": "IN_STOCK",
    "price": { "amountMicros": "15990000", "currencyCode": "USD" },
    "condition": "NEW",
    "gtins": ["9780007350896"]
  }
}

Vergleichen Sie das mit der alten Struktur: Aus "price": {"value": "15.99", "currency": "USD"} werden amountMicros und currencyCode, und die Verfügbarkeit wird zu einem Enum – aus in stock wird also IN_STOCK. Quelle: Googles Leitfaden zum Hinzufügen und Verwalten von Produkten.

Für Türkische Lira entsprechen 1.249,90 TRY "amountMicros": "1249900000". Berechnen Sie Micros mit Ganzzahlarithmetik auf Basis der kleinsten Währungseinheit und nicht durch Multiplikation einer Gleitkommazahl – sonst liefern Sie 1249899999 aus und wundern sich, warum die Preise um eine Haaresbreite abweichen.

Verwenden Sie außerdem das neue Feld versionNumber, wenn mehrere Jobs dasselbe Produkt schreiben. Es verhindert, dass ein älteres Update ein neueres überschreibt, wenn Anfragen in falscher Reihenfolge eintreffen.

Schritt 6: Batching ersetzen und den Status aus dem Produkt lesen

Es gibt kein customBatch. Ersetzen Sie es durch parallele asynchrone Anfragen, begrenzen Sie die Parallelität und wiederholen Sie nur die fehlgeschlagenen Anfragen. Führen Sie ein Ergebnisprotokoll pro Angebot, damit ein teilweiser Fehlschlag nicht unbemerkt zu einem veralteten Katalog wird.

Für den Status rufen Sie nicht mehr productstatuses auf. Lesen Sie stattdessen das verarbeitete Product, das seinen Status enthält. Google weist darauf hin, dass zwischen einem Insert oder Update und der Verfügbarkeit des finalen Produkts einige Minuten vergehen können – ein Lesezugriff direkt nach einem Schreibvorgang ist also kein Beleg für einen Fehler.

Schritt 7: Prüfen, bevor Sie den alten Pfad abschalten

Testen Sie den neuen Pfad zunächst mit einem kleinen, risikoarmen Ausschnitt, etwa 50 Produkten unter einem Feed-Label. Bewerten Sie die Umstellung dann anhand dieser Checkliste. Jeder Punkt sollte mit Ja beantwortet sein, bevor Sie den alten Aufrufer stilllegen.

  • Der Aufrufer authentifiziert sich mit dem registrierten Projekt und liefert sieben Tage in Folge keinen 410-Fehler.
  • Für jedes bediente Paar aus Feed-Label und Sprache existiert eine API-Datenquelle.
  • Im Testausschnitt stimmt das verarbeitete Produkt bei Preis, Verfügbarkeit und Link mit Ihrer Referenzquelle überein.
  • Nichts anderes schreibt dieselben Angebots-IDs noch über die alte Datenquelle.
  • Fehlgeschlagene Angebote werden mit erneutem Versuch protokolliert und nicht verworfen.
  • Für alle von Anbietern verwalteten Aufrufer in Ihrem Verzeichnis liegt eine schriftliche Bestätigung der Migration vor.

Der vierte Punkt verdient besondere Aufmerksamkeit. Ein zweiter Schreiber für dieselbe Angebots-ID – zum Beispiel der alte Aufrufer und eine neue API-Datenquelle – führt zu widersprüchlichen Werten. Legen Sie fest, welche Quelle für welches Produkt zuständig ist, und entfernen Sie die andere.

Wo dieser Leitfaden an seine Grenzen stößt

Wir haben diesen Leitfaden auf Basis der veröffentlichten Dokumentation von Google geschrieben und Ihre Codebasis nicht migriert. Einiges liegt außerhalb seines Rahmens. Google nennt keine Kriterien für Verlängerungen, daher können wir Ihnen nicht sagen, ob ein bestimmtes Projekt genehmigt wird. Die Produktübersicht dokumentiert die Verarbeitungszeit nur mit „einigen Minuten“; strengere Latenzerwartungen müssen Sie selbst messen. Lokales Inventar, regionales Inventar, Aktionen und Bewertungen haben jeweils eigene Sub-Ressourcen in der Merchant API, deren Zuordnungen wir hier nicht behandelt haben.

Wenn Sie überhaupt keine API-Integration selbst verantworten möchten, ist eine verwaltete Feed-Plattform die bessere Lösung als eine Neuentwicklung. Productsup und Feedonomics veröffentlichen beide Leitfäden zur Migration auf die Merchant API, und für ein Enterprise-Team mit ungewöhnlichen Datenmodellen passt womöglich einer der beiden besser als unser Setup. Speziell für Google Shopping ist unser eigenes Setup auf der Integrationsseite für Google Merchant Center beschrieben.

Häufig gestellte Fragen

Funktioniert die Content API for Shopping noch?

Nicht zuverlässig. Laut Google wurde sie am 18. August 2026 eingestellt; Anfragen ohne aktive Verlängerung schlagen seit dem 1. September 2026 sporadisch mit HTTP 410 fehl, und Anfang 2027 werden alle Endpunkte abgeschaltet.

Was steht in der 410-Fehlermeldung der Content API?

Die Meldung beginnt mit "Content API for Shopping was sunset on August 18, 2026". Die Antwort enthält Ihre GCP-Projekt-ID, die Projektnummer und einen Link zur Hilfe – daran erkennen Sie, welches Projekt Sie migrieren oder verlängern müssen.

Kann ich mit einer Verlängerung mehr Zeit bekommen?

Google stellt ein Formular für Verlängerungsanträge der Content API bereit. Genehmigte Verlängerungen schützen Ihr Projekt nur für den genehmigten Zeitraum vor den geplanten Fehlern und reichen nicht über die Abschaltung Anfang 2027 hinaus.

Warum verlangt productInputs.insert eine dataSource?

Schreibvorgänge in der Merchant API gehören zu einer expliziten Datenquelle. Anders als die alte API legt sie beim ersten Insert keine Datenquelle „Content API“ an. Sie müssen daher eine Datenquelle vom Typ API anlegen und deren Ressourcennamen übergeben.

Wie übermittle ich Preise in der Merchant API?

Verwenden Sie amountMicros als ganzzahligen String und currencyCode im ISO-4217-Format. Eine Million Micros entsprechen einer Währungseinheit, 15,99 USD sind also 15990000.

Unterstützt die Merchant API Batching?

Es gibt keine customBatch-Methode. Google empfiehlt asynchrone parallele Aufrufe – Sie sollten also eine eigene Begrenzung der Parallelität und Wiederholungen pro Angebot einbauen.

Wo ist productstatuses geblieben?

Der Status ist jetzt Teil der verarbeiteten Product-Ressource. Lesen Sie ihn mit products.get oder products.list aus und denken Sie daran, dass die Verarbeitung einem Insert um einige Minuten hinterherhinken kann.

Auf welcher Version der Merchant API sollte ich aufbauen?

Bauen Sie auf v1 auf, die seit Juli 2025 allgemein verfügbar ist. Die Version v1beta wurde am 28. Februar 2026 eingestellt, daher funktionieren Tutorials, die darauf basieren, nicht mehr.

Prüfen Sie, was Google tatsächlich sieht

Nach der Migration ist der schnellste Plausibilitätscheck ein Vergleich Ihres Quell-Feeds mit dem, was Merchant Center verarbeitet hat. Prüfen Sie Ihren Live-Feed mit unserem kostenlosen Produktfeed-Audit-Tool, um einen Score für Vollständigkeit und Qualität zu erhalten, und beheben Sie alle markierten Punkte vor dem nächsten Kampagnenzyklus.

Möchten Sie, dass jemand Ihren Feed noch einmal prüft? Wir gehen ihn gemeinsam mit Ihnen durch und zeigen Ihnen die Lücken vor Ihrer nächsten Einreichung.
Kostenloses Audit starten
Cagdas Polat
Geschrieben von
Cagdas Polat

Mitgründer von Feedance, wo er seinen Hintergrund als Computeringenieur und Marketer nutzt, um analytische Erkenntnisse voranzutreiben. Mit einem klaren Fokus darauf, Daten in umsetzbare Strategien zu verwandeln, unterstützt er Marken dabei, im digitalen Umfeld deutlich zu wachsen.

LinkedIn

Sehen Sie, welche
Produkte Umsatz bringen.

Verbinden Sie Ihren Feed und GA4. Wir zeigen Product Score, 4T, Price War und Broken Size für Ihren eigenen Katalog.