Mitä Googlen API:issa muuttui tänä vuonna — ja mitä sille pitää tarkalleen tehdä

Koko vuosi yhdessä lauseessa

Kaksi päivättyä katkaisuhetkeä rikkoo järjestelmäsi, jos jätät ne huomiotta — Content API for Shopping sulkeutuu 18. elokuuta 2026, ja Dynamic Search Ads päivittyy automaattisesti AI Maxiin syyskuussa 2026 — ja kolmas muutos, uusi kuukausittainen julkaisutahti, vanhentaa API-versiosi hiljaa nopeammin kuin ennen. Kaikki muu Googlen tänä vuonna julkaisema on mahdollisuus, ei velvollisuus. Tämä juttu käy jokaisen muutoksen läpi samalla tavalla: mikä muuttui, miksi sillä on väliä sinun tilillesi, ja tarkka kutsu, payload tai migraatio, joka pitää ajaa — tärkeysjärjestyksessä, kovin takaraja ensin.

En jätä mitään tasolle “sinun pitäisi migratoida”. Joka vaiheessa on konkreettinen artefakti — endpoint, joka korvaa vanhan, kokeen payload, GAQL-kysely — jotta näet tarkalleen, mitä rakentaa ennen kuin päivä koittaa.

Sananen siitä, miksi tällä ylipäätään on väliä. Vuosia Google Ads ja Merchant API:t olivat hidasliikkeinen pinta, johon saattoi koskea kerran vuodessa. Se on ohi. Alusta julkaisee nyt kuukausittain, kaksi sen suurinta pintaa kytketään pois päältä, ja hallinta, jota ennen pidit käsin, luovutetaan malleille. Edelle pääsevät ne tilit, jotka käsittelivät tätä vuotta migraatioprojektina, eivät ylläpitoprojektina.

Takaraja #1 — Content API for Shopping → Merchant API (18.8.2026)

Tämä on vuoden kovin päivä, joten se tulee ensin.

Mikä muuttui. Content API for Shopping v2.1 sulkeutuu 18. elokuuta 2026. Sen seuraaja, Merchant API v1, julkaistiin GA-vaiheessa heinäkuussa 2025, ja väliaikainen v1beta sulkeutui jo 28. helmikuuta 2026. Vanha monoliitti korvataan fokusoiduilla ali-API:eilla — datasources, products, inventories, reports, notifications.

Miksi sillä on väliä tilillesi. Kaikki, mikä koskettaa feediäsi vanhan API:n kautta, lakkaa toimimasta tuona päivänä: feed-lataukset, täydentävät feedit, custom labelit, hinta- ja saldopäivitykset sekä hylkäysten lukeminen. Ei “kiva migratoida” vaan kova katkaisuhetki. Jos päivittäinen skripti pitää hintasi synkassa, se vaikenee 18. elokuuta ja feedisi ajautuu hiljalleen vanhentuneeksi, kunnes joku huomaa menetetyn liikevaihdon.

Mitä tehdä. Rakenna uudelleen ali-API-rakennetta vasten. Migraation muoto on mekaaninen — host, polku ja resurssimalli muuttuvat, mutta tarkoitus pysyy samana. Tässä on ennen/jälkeen yleisimmälle yksittäiselle kutsulle, tuotteen upsertille:

# VANHA — Content API for Shopping v2.1 (pois 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"} }'

# UUSI — Merchant API v1 (productInputs-ali-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": "fi", "feedLabel": "FI",
        "attributes": { "title": "...", "price": {"amountMicros":"19900000","currencyCode":"EUR"} } }'

(Endpoint-hostit ja ali-API-jako ovat Googlen dokumenteista; vahvista resurssisi tarkka pyyntörunko Merchant API -referenssiä vasten ennen kuin julkaiset — kenttänimet muuttuivat, eivät pelkkä URL.)

Kohde on aidosti parempi kuin se, minkä se korvaa, ja juuri sitä kukaan ei kerro. Kolme parannusta, jotka perit migratoimalla ilmaiseksi:

Jos olet aikonut vahvistaa feed-työkalujasi, sulkeutuminen on pakottava tekijä: rakenna kerran uudelleen, lähde liikkeelle siistimmällä virheenkäsittelyllä ja harvemmilla edestakaisilla kutsuilla kuin v2.1 koskaan salli.

Takaraja #2 — Dynamic Search Ads → AI Max (9/2026)

Toinen päivätty muutos, ja se, joka muotoilee uudelleen sen, kuinka paljon hallintaa pidät.

Mikä muuttui. AI Max for Search saavutti GA-vaiheen 15. huhtikuuta 2026 beetalanseerauksensa jälkeen toukokuussa 2025. Syyskuusta 2026 alkaen Google päivittää automaattisesti kaikki jäljellä olevat DSA:t, automaattisesti luodut elementit ja kampanjatason laajan vastaavuuden AI Maxiin. Sen jälkeen et voi luoda uutta DSA-kampanjaa — et käyttöliittymässä, et Editorissa, et API:n kautta.

Miksi sillä on väliä tilillesi. Vaihtokaupassa luovutat hallintaa ja saat vastineeksi nostoa. Koko ominaisuuspaketilla — hakulausekevastaavuus plus tekstin räätälöinti plus final-URL-laajennus — Google raportoi noin +7 % konversioita tai konversioarvoa verrattuna pelkkään lausekevastaavuuteen. Vastineeksi luovutat mallille vastaavuuden, elementtien tekstin ja laskeutumis-URL:n valinnan. Jos olet leiponut brändi- tai compliance-säännöt DSA-asetuksiisi käsin, hiljainen syyskuun päivitys voi alkaa huomaamatta ohjata liikennettä URL:eihin ja tekstiin, joita et ole hyväksynyt.

Mitä tehdä. Älä odota saadaksesi selville, mitä päivitys tekee luvuillesi — mittaa se nyt. Google julkaisi suojakaiteet ja mittauskoukut API:n kautta samaa tahtia ominaisuuden kanssa, joten voit A/B-testata vaihdon omalla datallasi ennen kuin se on pakollinen:

Käytännön siirto on viimeinen: luo ADOPT_AI_MAX-koe useammalle tilille, anna sen pyöriä ja lue sitten todellinen ero tavallisella GAQL-haulla — sen sijaan että saisit tietää vasta, kun päivitys on peruuttamaton:

-- ADOPT_AI_MAXin ajon jälkeen: lue avainsanaton vastaavuus, sitten kokeen ero
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 on yksi v24.1:ssä julkaistuista uusista koetyypeistä; targeting_expansion_view on v22:n raportointiresurssi. Vahvista kenttien saatavuus release notes -sivulta sille versiolle, jota kutsut.)

Takaraja #3 (jatkuva) — kuukausittaiset julkaisut, lyhyempi käyttöikä

Ei yksittäinen päivä, vaan kello, joka nyt tikittää aina.

Mikä muuttui. v23:sta (28. tammikuuta 2026) lähtien Google Ads API siirtyi kuukausittaiseen julkaisutahtiin: neljä pääversiota vuodessa plus kuukausittaiset pienversiot, ja vuoden tuki per pääversio.

Miksi sillä on väliä tilillesi. Nopeampi pääsy ominaisuuksiin ja nopeampi vanhentuminen. Versiot vanhentuvat julkaistun aikataulun mukaan — v20 saavuttaa elinkaaren lopun kesäkuussa 2026, v21 elokuussa, v22 lokakuussa. Kuukausittainen pieni versionkorotus on rikkomaton; pääversion sulkeutumisen ohittaminen tarkoittaa, että skriptisi alkavat palauttaa virheitä ilman muuta varoitusta kuin päivämäärä kalenterissa, jota et seurannut.

Mitä tehdä. Pinnaa versiosi ja seuraa sulkeutumiskalenteria. Halvin vakuutus on toistuva tarkistus, joka tietää, mitä versiota kutsut, ja hälyttää ~60 päivää ennen sen vanhentumista — API jopa raportoi pyynnön version takaisin, joten tarkistus on muutama rivi:

# Toistuva suojakaide: hälytä ~60 päivää ennen pinnatun version sulkeutumista.
from datetime import date

PINNED = "v22"                 # versio, johon asiakkaasi on pinnattu
SUNSET = {"v20": "2026-06-01", "v21": "2026-08-01", "v22": "2026-10-01"}  # sunset-dates-sivulta
sunset = SUNSET.get(PINNED)    # None kunnes versiosi saavuttaa julkaistun kalenterin
if sunset and (date.fromisoformat(sunset) - date.today()).days < 60:
    alert(f"{PINNED} sulkeutuu {sunset} — aikatauluta version korotus")  # pääversion korotus vaatii uudelleentestauksen

404 sulkeutuneesta versiosta on itse aiheutettu käyttökatko. Käsittele versionhallintaa jatkuvana toistuvana tehtävänä, älä palohälytyksenä.

Nyt hyötypuoli — AI siirtyy mainoksiin ja feediin

Kun takarajat on hoidettu, loppuvuosi on vipuvoimaa, jonka otat käyttöön omaan tahtiisi. Kaksi palvelua muutti elementti- ja feed-työn joksikin, jota voit skriptata läpi tuhansien SKU:iden:

• AssetGenerationService — Ads API, v22, suljettu beeta: AI-teksti- ja kuvageneraatio, PMax-kuvan parannuksella ja poiminnalla; v23.2 lisäsi VideoEnhancementin Googlen generoimalle videolle. Mainosgeneraatio siirtyy käyttöliittymästä ohjelmoitavaan kerrokseen.
• Product Studio — Merchant API, alfa huhtikuusta 2025: AI:n generoimat tuotteiden otsikot ja kuvaukset plus AutomatedDiscounts reaaliaikaiseen hinnoitteluun. Feedin laatu on Shoppingin ja PMaxin suorituskyvyn katto, joten otsikoiden uudelleenkirjoittaminen API-tasolla tarkoittaa tuhansien SKU:iden parantamista massana ilman käsityötä.

Konkreettinen putki, jonka tämä avaa: lue SKU feedistä → generoi sääntöjenmukainen otsikko/kuvaus ja kuvaelementit → työnnä ne suoraan elementtiryhmään ilman manuaalista Canva-vaihetta välissä. Molemmat palvelut ovat pre-GA — käsittele niitä pilottina katalogin osalla, ei katalogin laajuisena käyttöönottona, kunnes ne valmistuvat.

Ja putkisto — Ads ja Merchant samassa paikassa

Vuoden aliarvostetuin muutos on vaatimaton: verkkokauppatilin kaksi puoliskoa kohtaavat vihdoin.

Mikä muuttui. 22. huhtikuuta 2026 lähtien Merchant API on tavoitettavissa Google Ads Scriptsistä. Yhdistettynä product_filtersiin (ehdollinen feedin jako Google Adsin kanssa, julkaistu marraskuussa 2025) ja CartDataSalesViewhin (v24) silmukka feedin terveyden ja mainoskulun välillä sulkeutuu yhden ympäristön sisällä.

Miksi sillä on väliä tilillesi. Vanha jako — kampanjat Scriptsissä, feed hallinnoituna jossain muualla — tarkoitti, että hylätty tuote poltti budjettia, kunnes ihminen huomasi. Nyt yksi skripti voi reagoida feedin hylkäykseen pysäyttämällä kampanjan tai poistamalla SKU:n PMax-listausryhmästä. Ja CartDataSalesView tuo tuotetason konversiosegmentoinnin API:in, joten saat SKU-tason ROASin ilman kampanjadatan manuaalista yhdistämistä feediin:

-- Tuotetason ROAS suoraan API:sta (v24+), ei manuaalista feedin yhdistämistä
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

Tuo yksi kysely on syöte kannattavuusporrastukseen, jonka rakensit ennen käsin joka kuukausi. (Resurssi on cart_data_sales_view, julkaistu v24:ssä; vahvista segmenttien saatavuus versiosi release notesista.)

Vuosi yhdellä aikajanalla

Jokainen alla oleva pääversio tulee virallisista release notesista; Merchant-merkkipaalut Merchant API:n latest updatesista. Oikeanpuoleinen sarake on ainoa, jonka pitäisi ohjata kalenteriasi — kaikki päivätty on neuvottelematonta.

[KOVA 18.8]   1. Feedin migraatio → pois v2.1:stä, Merchantin ali-API:eihin
[KOVA 9/]     2. DSA-inventaario → aja ADOPT_AI_MAX A/B ensin
[JATKUVA]     3. Versioseuranta → hälytä 60 päivää ennen sulkeutumista
[hyöty]       4. Elementtiputki → AssetGenerationService / Product Studio
[hyöty]       5. SKU-ROAS → cart_data_sales_view -porrastus
[hyöty]       6. Suljettu silmukka → Merchant-in-Scripts: hylkäys → pysäytys

FAQ