Wat er dit jaar veranderde in de API's van Google — en wat je precies moet doen

Het hele jaar in één zin

Twee gedateerde deadlines breken je stack als je ze negeert — de Content API for Shopping gaat uit op 18 augustus 2026, en Dynamic Search Ads upgraden in september 2026 automatisch naar AI Max — en een derde verandering, de nieuwe maandelijkse release-cadans, laat je API-versie stilletjes sneller verouderen dan voorheen. Al het andere dat Google dit jaar uitbracht is kans, geen verplichting. Dit stuk loopt elke verandering op dezelfde manier door: wat veranderde, waarom het ertoe doet voor jouw account, en de exacte call, payload of migratie die je moet draaien — in volgorde van prioriteit, de zwaarste deadline eerst.

Ik laat het nergens bij “je zou moeten migreren.” Bij elke stap staat het concrete artefact — het endpoint dat het oude vervangt, de experiment-payload, de GAQL-query — zodat je precies ziet wat je moet bouwen voordat de datum aanbreekt.

Even waarom dit überhaupt belangrijk is. Jarenlang waren de Google Ads- en Merchant-API’s een traag bewegend oppervlak dat je één keer per jaar kon aanraken. Dat is voorbij. Het platform brengt nu maandelijks uit, twee van zijn grootste oppervlakken worden uitgezet, en de controle die je vroeger met de hand had, wordt overgedragen aan modellen. De accounts die er beter uit komen, zijn die die dit jaar als migratieproject behandelden, niet als onderhoud.

Deadline #1 — Content API for Shopping → Merchant API (18 aug 2026)

Dit is de zwaarste datum van het jaar, dus die gaat eerst.

Wat veranderde. Content API for Shopping v2.1 gaat uit op 18 augustus 2026. De opvolger, Merchant API v1, werd GA in juli 2025, en de tussenstap v1beta ging al uit op 28 februari 2026. De oude monoliet wordt vervangen door gerichte sub-API’s — datasources, products, inventories, reports, notifications.

Waarom het ertoe doet voor jouw account. Alles wat via de oude API aan je feed raakt, stopt op die datum met werken: feed-uploads, supplementaire feeds, custom labels, prijs- en voorraadupdates, afkeuringsuitlezingen. Geen “leuk om te migreren” — een harde deadline. Houdt een dagelijks script je prijzen gesynchroniseerd, dan valt het op 18 augustus stil en drijft je feed langzaam uit de pas tot iemand de gemiste omzet opmerkt.

Wat te doen. Bouw opnieuw op tegen de sub-API-structuur. De vorm van de migratie is mechanisch — de host, het pad en het resourcemodel veranderen, de intentie blijft gelijk. Hier is het voor/na voor de meest voorkomende call, een product-upsert:

# OLD — Content API for Shopping v2.1 (off on 2026-08-18)
curl -X POST \
  "https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{ "offerId": "SKU-123", "title": "...", "price": {"value":"19.90","currency":"EUR"} }'

# NEW — Merchant API v1 (productInputs sub-API)
curl -X POST \
  "https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs:insert?dataSource=accounts/{account}/dataSources/{ds}" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{ "channel": "ONLINE", "offerId": "SKU-123", "contentLanguage": "en", "feedLabel": "US",
        "attributes": { "title": "...", "price": {"amountMicros":"19900000","currencyCode":"EUR"} } }'

(Endpoint-hosts en de sub-API-splitsing komen uit de docs van Google; bevestig de exacte requestbody voor jouw resource tegen de Merchant API-referentie voordat je live gaat — veldnamen veranderden, niet alleen de URL.)

De bestemming is oprecht beter dan wat ze vervangt, en dat is het deel dat niemand je vertelt. Drie verbeteringen die je gratis erft door te migreren:

Wilde je je feed-tooling toch al verstevigen, dan is de shutdown de aanleiding: bouw één keer opnieuw en kom eruit met schonere foutafhandeling en minder round-trips dan v2.1 ooit toeliet.

Deadline #2 — Dynamic Search Ads → AI Max (sep 2026)

De tweede gedateerde verandering, en degene die herschikt hoeveel controle je houdt.

Wat veranderde. AI Max for Search werd GA op 15 april 2026 na een bètalancering in mei 2025. Vanaf september 2026 upgradet Google alle resterende DSA, automatisch gemaakte componenten en breed zoeken op campagneniveau automatisch naar AI Max. Daarna kun je geen nieuwe DSA-campagne meer maken — niet in de UI, niet in Editor, niet via de API.

Waarom het ertoe doet voor jouw account. De ruil is controle voor stijging. Met de volledige featureset — matchen op zoekterm plus tekstaanpassing plus uitbreiding van de definitieve URL — rapporteert Google ongeveer +7% conversies of conversiewaarde boven alleen matchen op zoekterm. In ruil geef je het model de matching, de componenttekst en de keuze van de landings-URL. Heb je merk- of complianceregels met de hand in je DSA-opzet ingebakken, dan kan een stille upgrade in september stilletjes verkeer naar URL’s en teksten gaan sturen die jij niet hebt goedgekeurd.

Wat te doen. Wacht niet af wat de upgrade met je cijfers doet — meet het nu. Google leverde de guardrails en de meethaken via de API in de pas met de feature, dus je kunt de overstap A/B-testen op je eigen data voordat het verplicht is:

De praktische zet is de laatste: maak een ADOPT_AI_MAX-experiment over accounts heen, laat het draaien en lees dan het echte verschil af met een normale GAQL-pull — in plaats van het te ontdekken nadat de upgrade onomkeerbaar is:

-- After ADOPT_AI_MAX runs: read the keywordless match, then the trial delta
SELECT campaign.name,
       metrics.conversions,
       metrics.conversions_value,
       metrics.cost_micros
FROM targeting_expansion_view
WHERE segments.date DURING LAST_30_DAYS

(ADOPT_AI_MAX is een van de nieuwe experimenttypes uit v24.1; targeting_expansion_view is de rapportageresource uit v22. Bevestig de beschikbaarheid van velden tegen de release notes voor de versie die je aanroept.)

Deadline #3 (doorlopend) — maandelijkse releases, kortere houdbaarheid

Geen enkele datum, maar een klok die nu altijd tikt.

Wat veranderde. Vanaf v23 (28 januari 2026) is de Google Ads API overgestapt op een maandelijkse release-cadans: vier major-versies per jaar plus maandelijkse minor-versies, met één jaar ondersteuning per major-versie.

Waarom het ertoe doet voor jouw account. Snellere toegang tot features, en snellere veroudering. Versies verouderen volgens een gepubliceerd schema — v20 bereikt zijn end-of-life in juni 2026, v21 in augustus, v22 in oktober. Een maandelijkse minor-bump is niet-breaking; een major-sunset missen betekent dat je scripts errors gaan teruggeven zonder andere waarschuwing dan een datum in een kalender waar je niet naar keek.

Wat te doen. Pin je versie en houd de sunset-kalender in de gaten. De goedkoopste verzekering is een terugkerende check die weet welke versie je aanroept en ~60 dagen vóór verloop waarschuwt — de API rapporteert zelfs de requestversie terug, dus de check is een paar regels:

# Recurring guardrail: alert ~60 days before your pinned version sunsets.
from datetime import date

PINNED = "v22"                 # the version your client is pinned to
SUNSET = {"v20": "2026-06-01", "v21": "2026-08-01", "v22": "2026-10-01"}  # from sunset-dates page
sunset = SUNSET.get(PINNED)    # None until your version reaches the published calendar
if sunset and (date.fromisoformat(sunset) - date.today()).days < 60:
    alert(f"{PINNED} sunsets {sunset} — schedule the version bump")  # major bump needs a re-test

Een 404 van een uitgefaseerde versie is een storing die je jezelf aandoet. Behandel versiebeheer als een vaste terugkerende taak, niet als een brandoefening.

Nu de winst — AI verhuist naar creative en feed

Met de deadlines afgehandeld is de rest van het jaar hefboomkracht die je op je eigen schema overneemt. Twee diensten maakten van component- en feedwerk iets dat je over duizenden SKU’s kunt scripten:

• AssetGenerationService — Ads API, v22, gesloten bèta: AI-tekst- en beeldgeneratie, met PMax-beeldverbetering en -extractie; v23.2 voegde VideoEnhancement toe voor door Google gegenereerde video. Creative-generatie verhuist uit de UI naar een programmeerbare laag.
• Product Studio — Merchant API, alpha sinds april 2025: AI-gegenereerde producttitels en -beschrijvingen, plus AutomatedDiscounts voor realtime prijsstelling. Feedkwaliteit is het plafond op Shopping- en PMax-prestaties, dus titels herschrijven op API-niveau betekent duizenden SKU’s in bulk verbeteren zonder handwerk.

De concrete pijplijn die dit ontsluit: lees een SKU uit de feed → genereer een compliant titel/beschrijving en beeldcomponenten → push ze direct in de componentengroep, zonder handmatige Canva-stap ertussen. Beide diensten zijn pre-GA — behandel ze als een pilot op een deel van de catalogus, niet als een catalogusbrede uitrol, tot ze uit bèta zijn.

En de bedrading — Ads en Merchant op één plek

De meest onderschatte verandering van het jaar is onspectaculair: de twee helften van een e-commerce-account ontmoeten elkaar eindelijk.

Wat veranderde. Sinds 22 april 2026 is de Merchant API bereikbaar vanuit Google Ads Scripts. Gecombineerd met product_filters (voorwaardelijk feed delen met Google Ads, uitgebracht november 2025) en CartDataSalesView (v24) sluit de lus tussen feedgezondheid en advertentie-uitgaven binnen één omgeving.

Waarom het ertoe doet voor jouw account. De oude scheiding — campagnes in Scripts, feed elders beheerd — betekende dat een afgekeurd product budget bleef opbranden tot een mens het opmerkte. Nu kan één script reageren op een feed-afkeuring door een campagne te pauzeren of de SKU uit een PMax-listinggroep te trekken. En CartDataSalesView brengt conversiesegmentatie op productniveau in de API, dus je krijgt ROAS op SKU-niveau zonder campagnedata handmatig aan de feed te koppelen:

-- Product-level ROAS straight from the API (v24+), no manual feed stitching
SELECT segments.product_item_id,
       metrics.conversions_value,
       metrics.cost_micros
FROM cart_data_sales_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.conversions_value DESC

Die ene query is de input voor een winstgevendheidstiering die je vroeger elke maand met de hand opnieuw bouwde. (De resource is cart_data_sales_view, uitgebracht in v24; bevestig de beschikbaarheid van segmenten in de release notes voor jouw versie.)

Het jaar op één tijdlijn

Elke major-versie hieronder komt uit de officiële release notes; de Merchant-mijlpalen uit de Merchant API latest updates. De rechterkolom is de enige die je kalender zou moeten sturen — alles met een datum is niet-onderhandelbaar.

[HARD 18 aug] 1. Feed-migratie → van v2.1 af, op Merchant sub-API's
[HARD sep]    2. DSA-inventaris → draai eerst ADOPT_AI_MAX A/B
[DOORLOPEND]  3. Versiewacht → waarschuw 60 dagen pre-sunset
[winst]       4. Component-pijplijn → AssetGenerationService / Product Studio
[winst]       5. SKU-ROAS → cart_data_sales_view-tiering
[winst]       6. Gesloten lus → Merchant-in-Scripts: afkeuring → pauze

FAQ