NieuwProduct Score, 4T Segmentation, Price War en Broken Size zijn live.Bekijk wat er nieuw is
Feedance
Artikel

Content API 410-fouten oplossen: je feedpijplijn migreren naar Merchant API

De Content API for Shopping geeft nu 410-fouten. Vind je resterende aanroepen, koppel ze aan Merchant API en controleer je producten in Merchant Center.

Cagdas PolatCagdas Polat
9 min. leestijd
Content API 410-fouten oplossen: je feedpijplijn migreren naar Merchant API

Google heeft de Content API for Shopping op 18 augustus 2026 uitgefaseerd. Sinds 1 september mislukken verzoeken van projecten zonder goedgekeurde verlenging af en toe met HTTP 410, en begin 2027 worden de endpoints volledig uitgeschakeld (de uitfaseringsmelding van Google). Als een script, plug-in of eigen connector je producten nog via de oude API naar Merchant Center pusht, gaat een deel van die updates nu al verloren.

Deze gids is bedoeld voor developers en feedeigenaren die die pijplijn zelf onderhouden. Aan het eind kun je elke resterende Content API-aanroep vinden, elke aanroep koppelen aan het equivalent in Merchant API, de databron aanmaken die de nieuwe API vereist en in Merchant Center bevestigen dat producten en prijzen nog steeds binnenkomen.

Zo zie je of de uitfasering jou raakt

De fout is makkelijk te missen omdat hij af en toe optreedt. Google documenteert de foutbody als een 410 met een melding die begint met "Content API for Shopping was sunset on August 18, 2026", inclusief je Google Cloud-project-ID, projectnummer en een link naar het helpcentrum. Zoek in je integratielogs naar die tekst en naar shoppingcontent.googleapis.com.

Drie symptomen verschijnen meestal voordat iemand een log leest:

  • Prijs- of beschikbaarheidswijzigingen bereiken Google uren te laat, of alleen bij sommige runs.
  • Een dagelijkse job meldt succes voor de meeste batches en faalt bij een paar.
  • Merchant Center toont verouderde data terwijl je winkel de juiste prijs toont.

Het laatste symptoom heeft nog een mogelijke oorzaak: de automatische itemupdates van Google die je waarden overschrijven. Dat behandelen we apart in voorkomen dat Google ongemerkt de prijs en beschikbaarheid in je feed overschrijft. Sluit eerst de 410-fouten uit, want die zijn goedkoper te bevestigen.

Stap 1: Inventariseer elke aanroeper van de oude API

Het advies van Google zelf is je applicatiecode na te lopen op directe aanroepen van Content API-endpoints. In de praktijk zitten de aanroepen op vier plekken: de Google-plug-in van je winkelplatform, een maatwerkscript van een eerdere developer, middleware voor feeds of ERP, en een Google Ads-script of Apps Script dat iemand jaren geleden heeft ingepland.

Maak een kort register met één rij per aanroeper. Noteer wat hij doet, met welk Google Cloud-project hij authenticeert en wie de eigenaar is. Het project-ID is belangrijk, omdat verlengingen en de 410-melding eraan gekoppeld zijn.

AanroeperWat hij verstuurtEigenaarActie
Winkelplug-inVolledige catalogus, dagelijksPlatformleverancierVraag welke API-versie hij nu gebruikt
VoorraadscriptPrijs en voorraad, elk uurJe developerMigreren naar Merchant API
FeedmanagementtoolGeoptimaliseerde feedToolleverancierVraag om schriftelijke bevestiging van de migratie

Beheert een leverancier de koppeling, dan is het jouw taak om het te vragen, niet om het opnieuw te bouwen. Productsup en Feedonomics hebben allebei migratiebeschrijvingen gepubliceerd, en een volwassen leverancier is al overgestapt. Stel elke leverancier op je lijst dezelfde vraag en bewaar de antwoorden.

Stap 2: Bepaal of je een verlenging nodig hebt

Google biedt een aanvraagformulier voor een Content API-verlenging voor organisaties die meer tijd nodig hebben. Goedgekeurde verlengingen beschermen een project tijdens de goedgekeurde periode tegen de geplande foutresponses, en ze lopen niet door na de definitieve uitschakeling begin 2027. Google vermeldt niet wie in aanmerking komt.

Gebruik deze beslisregel. Kan elke aanroeper binnen een paar weken worden gemigreerd en getest, sla de verlenging dan over en besteed de tijd aan de migratie. Hoort een aanroeper bij een leverancier met een bevestigde maar nog niet ingeplande migratie, vraag dan alleen voor dat project een verlenging aan. Een verlenging is een buffer, geen plan.

Stap 3: Koppel elke aanroep aan het equivalent in Merchant API

Merchant API splitst het oude monoliet op in sub-API's en zet de versie in de URL (/products/v1/). Versie v1 werd in juli 2025 algemeen beschikbaar en v1beta werd op 28 februari 2026 uitgefaseerd, dus bouw op v1 en negeer eventuele v1beta-tutorials die je tegenkomt (releasenotes van Merchant API).

Content APIMerchant APIWat er verandert
products.insertproductInputs.insertVereist een queryparameter dataSource
products.updateproductInputs.patchBlijvende update van één productinput
products.deleteproductInputs.deleteVereist een parameter dataSource
products.get / listproducts.get / listGeeft het verwerkte product terug, alleen-lezen
productstatuses.get / listproducts.get / listStatus maakt nu deel uit van de Product-resource
custombatchParallelle asynchrone aanroepenEr bestaat geen customBatch-methode
datafeedsdataSourcesElke databron is gericht op één feedlabel en één taal

Bron: de productmigratiemapping en databronmapping van Google. De conceptuele verschuiving is de splitsing tussen een ProductInput, de ruwe data die je schrijft, en een Product, het verwerkte resultaat dat je alleen kunt lezen. Een verwerkt product wordt opgebouwd uit één primaire input plus eventuele aanvullende inputs, nadat feedregels zijn uitgevoerd (productoverzicht).

Stap 4: Maak de API-databron aan voordat je iets invoegt

Dit is de stap waarop de meeste eerste migraties stuklopen. De Content API maakte bij je eerste insert automatisch een databron "Content API" aan. Merchant API doet dat niet. Google geeft aan dat je minstens één databron van het type API moet aanmaken, en dat de Products-sub-API alleen naar databronnen van dat type kan schrijven (databronmigratie).

Elke databron hoort nu bij één combinatie van feedLabel en contentLanguage. Bediende je Turkije in het Turks en de VAE in het Engels vanuit één feed met meerdere doelen, dan heb je nu aparte databronnen nodig. Maak ze aan via de Data Sources-sub-API of in Merchant Center en gebruik vervolgens de resulterende resourcenaam, in de vorm accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}, bij elke schrijfactie.

Stap 5: Herschrijf de payload, met een uitgewerkt voorbeeld

Drie veldwijzigingen veroorzaken de meeste bugs. Prijs verandert van een decimale string in gehele micros, waarbij een miljoen micros één valuta-eenheid is. Productattributen verhuizen naar een object productAttributes. En targetCountry wordt vervangen door feedLabel, terwijl channel verdwijnt.

De oude productidentifier zag er zo uit; de nieuwe gebruikt tildes en laat het kanaal weg:

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

Een productinput die de eigen gids van Google als voorbeeld gebruikt, ziet er zo uit (invoegen met 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"]
  }
}

Vergelijk dat met de oude vorm: "price": {"value": "15.99", "currency": "USD"} wordt amountMicros en currencyCode, en beschikbaarheid wordt een enum, dus in stock wordt IN_STOCK. Bron: de gids van Google voor het toevoegen en beheren van producten.

Voor Turkse lira is 1.249,90 TRY "amountMicros": "1249900000". Bereken micros met gehele getallen op basis van de kleinste munteenheid, niet door een float te vermenigvuldigen, anders verstuur je 1249899999 en vraag je je af waarom prijzen een haar verschillen.

Gebruik ook het nieuwe veld versionNumber wanneer meerdere jobs hetzelfde product schrijven. Het voorkomt dat een oudere update een nieuwere overschrijft wanneer verzoeken in de verkeerde volgorde binnenkomen.

Stap 6: Vervang batching en lees de status uit het product

Er is geen customBatch. Vervang het door parallelle asynchrone verzoeken, begrens het aantal gelijktijdige verzoeken en probeer alleen de mislukte opnieuw. Houd per aanbieding een resultatenlog bij, zodat een gedeeltelijke fout niet ongemerkt tot een verouderde catalogus leidt.

Stop voor de status met het aanroepen van productstatuses. Lees in plaats daarvan het verwerkte Product, dat zijn status bevat. Google merkt op dat er een paar minuten vertraging kan zitten tussen een insert of update en het moment waarop het definitieve product beschikbaar is, dus een leesactie direct na een schrijfactie is geen test op mislukking.

Stap 7: Controleer alles voordat je het oude pad uitschakelt

Laat het nieuwe pad eerst draaien op een klein deel met weinig risico, zoals 50 producten in één feedlabel. Beoordeel de overstap daarna met deze checklist. Elke regel moet een ja zijn voordat je de oude aanroeper uitfaseert.

  • De aanroeper authenticeert met het project dat je hebt geregistreerd en geeft zeven dagen achter elkaar geen 410.
  • Er bestaat een API-databron voor elke combinatie van feedlabel en taal die je bedient.
  • Voor het testdeel komt het verwerkte product qua prijs, beschikbaarheid en link overeen met je bron van waarheid.
  • Niets anders schrijft nog dezelfde offer-ID's vanuit de oude databron.
  • Mislukte aanbiedingen worden gelogd en opnieuw geprobeerd, niet weggegooid.
  • Alle door leveranciers beheerde aanroepers in je register hebben een schriftelijke bevestiging van de migratie.

Het vierde punt verdient aandacht. Een tweede schrijver voor dezelfde offer-ID, bijvoorbeeld de oude aanroeper en een nieuwe API-databron, is precies hoe je tegenstrijdige waarden krijgt. Bepaal welke bron eigenaar is van elk product en verwijder de andere.

Waar deze gids tekortschiet

We hebben dit geschreven op basis van de gepubliceerde documentatie van Google en hebben jouw codebase niet gemigreerd. Een aantal zaken valt erbuiten. Google vermeldt niet wie in aanmerking komt voor een verlenging, dus we kunnen je niet vertellen of een bepaald project wordt goedgekeurd. Het productoverzicht documenteert de timing niet verder dan "een paar minuten", dus elke strengere verwachting over latency moet je zelf meten. Lokale voorraad, regionale voorraad, promoties en reviews hebben elk hun eigen sub-resources in Merchant API, en hun mappings hebben we hier niet behandeld.

Wil je helemaal geen API-integratie in eigen beheer hebben, dan is een beheerd feedplatform een beter antwoord dan herschrijven. Productsup en Feedonomics publiceren allebei richtlijnen voor de migratie naar Merchant API, en voor een enterpriseteam met ongebruikelijke datamodellen kan elk van beide beter passen dan onze setup. Voor Google Shopping specifiek staat onze eigen setup beschreven op de integratiepagina voor Google Merchant Center.

Veelgestelde vragen

Werkt de Content API for Shopping nog?

Niet betrouwbaar. Volgens Google is hij op 18 augustus 2026 uitgefaseerd, begonnen verzoeken zonder actieve verlenging vanaf 1 september 2026 af en toe te mislukken met HTTP 410, en worden alle endpoints begin 2027 uitgeschakeld.

Wat zegt de 410-fout van de Content API?

De melding begint met "Content API for Shopping was sunset on August 18, 2026". De response bevat je GCP-project-ID, projectnummer en een link naar het helpcentrum, waaraan je ziet welk project je moet migreren of verlengen.

Kan ik meer tijd krijgen met een verlenging?

Google biedt een aanvraagformulier voor een Content API-verlenging. Goedgekeurde verlengingen beschermen je project alleen tijdens de goedgekeurde periode tegen de geplande fouten, en ze lopen niet door na de uitschakeling begin 2027.

Waarom vraagt productInputs.insert om een dataSource?

Schrijfacties in Merchant API horen bij een expliciete databron. Anders dan de oude API maakt hij bij je eerste insert geen databron "Content API" aan, dus je moet een databron van het type API aanmaken en de resourcenaam ervan meegeven.

Hoe verstuur ik prijzen in Merchant API?

Gebruik amountMicros als string met een geheel getal en currencyCode in ISO 4217-formaat. Een miljoen micros is één valuta-eenheid, dus 15,99 USD is 15990000.

Ondersteunt Merchant API batching?

Er is geen methode customBatch. Het advies van Google is asynchrone parallelle aanroepen te gebruiken, wat betekent dat je zelf een limiet voor gelijktijdige verzoeken en retries per aanbieding moet toevoegen.

Waar is productstatuses gebleven?

De status maakt nu deel uit van de verwerkte Product-resource. Gebruik products.get of products.list om hem te lezen, en houd er rekening mee dat de verwerking een paar minuten achter kan lopen op een insert.

Op welke versie van Merchant API moet ik bouwen?

Bouw op v1, dat in juli 2025 algemeen beschikbaar werd. De versie v1beta is op 28 februari 2026 uitgefaseerd, dus tutorials die daarop zijn gebaseerd, werken niet meer.

Controleer wat Google echt ziet

Na de migratie is de snelste controle je bronfeed te vergelijken met wat Merchant Center heeft verwerkt. Haal je live feed door onze gratis tool voor productfeedaudits voor een score voor volledigheid en kwaliteit, en los op wat de tool signaleert voor de volgende advertentiecyclus.

Wil je dat iemand anders ook naar je feed kijkt? We nemen hem samen met je door en laten zien waar de gaten zitten, nog voor je volgende inzending.
Doe een gratis audit
Cagdas Polat
Geschreven door
Cagdas Polat

Medeoprichter van Feedance, waar hij zijn achtergrond als computeringenieur en marketeer inzet om analytische inzichten te leveren. Met een sterke focus op het omzetten van data in concrete strategieën zet hij zich in om merken te helpen aanzienlijk te groeien in het digitale landschap.

LinkedIn

Zie welke
producten opbrengen.

Koppel je feed en GA4. We tonen Product Score, 4T, Price War en Broken Size op je eigen catalogus.