Vuosi Google Ads API:n parissa: kaksi kovaa takarajaa, loput on mahdollisuutta

Tammikuussa Google julkaisi Ads API:n version 23 ja ilmoitti, että siitä lähtien uusi versio ilmestyy joka kuukausi. Luin tiedotteen kahdesti. Olen kirjoittanut koodia tätä API:a vasten kaksitoista vuotta, ja suurimman osan siitä ajasta se oli hidas pinta, jossa käytiin kerran vuodessa, nostettiin versionumeroa ja unohdettiin.

Sitten tein sen, minkä nuo vuodet ovat opettaneet. Avasin Lyntin koodikannan ja hain shoppingcontent.googleapis.com. Jokainen osuma on skripti, joka kuolee 18. elokuuta 2026, päivänä jona Content API for Shopping sammuu. Heti sen takana odottaa toinen päivämäärä. Syyskuussa 2026 jokainen jäljellä oleva Dynamic Search Ads -kampanja päivittyy automaattisesti AI Maxiksi, halusit tai et.

Nuo kaksi kelloa ovat Googlen API-vuoden velvollisuudet. Kaikki muu, mitä alusta julkaisi, on mahdollisuutta. Tekoälypalvelut luoville aineistoille, tuotetason myyntiraportointi, Merchant API Google Ads Scriptsin sisällä. Käyn vuoden läpi prioriteettijärjestyksessä, kovin takaraja ensin. Jokaisesta muutoksesta: mikä se on, miksi se koskee sinun tiliäsi ja mikä tarkka kutsu, payload tai migraatio pitää ajaa.

En jätä mitään tasolle “sinun pitäisi migroida”. Takaraja ilman konkreettista artefaktia on pelkkää ahdistusta. Joka askeleella saat endpointin, joka korvaa vanhan, kokeilun payloadin tai GAQL-kyselyn, jotta näet tarkalleen, mitä rakentaa ennen kuin päivä koittaa.

Takaraja yksi: Content API for Shopping kuolee 18. elokuuta 2026

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

Mikä muuttui. Content API for Shopping v2.1 sammuu 18. elokuuta 2026. Sen seuraaja, Merchant API v1, tuli GA:han heinäkuussa 2025, ja välivaihe v1beta sammui jo 28. helmikuuta 2026. Vanhan monoliitin korvaavat kohdennetut ala-API:t. datasources, products, inventories, reports, notifications.

Miksi se koskee tiliäsi. Kaikki, mikä koskee feediisi vanhan API:n kautta, lakkaa toimimasta sinä päivänä. Feedien lataukset, täydentävät feedit, omat tunnisteet, hinta- ja varastopäivitykset, hylkäysten luku. Tämä ei ole “olisi kiva migroida”, tämä on kova katkaisu. Jos päivittäinen skripti pitää hintasi synkassa, se hiljenee 18. elokuuta ja feedisi ajautuu hitaasti irti todellisuudesta, kunnes joku huomaa menetetyn liikevaihdon. Olen nähnyt tämän vikaantumistavan oikeilla tileillä, ja kallista ei ole koskaan itse katko, vaan viikot, joina kukaan ei huomaa sitä.

Mitä tehdä. Rakenna uudelleen ala-API-rakennetta vasten. Migraatio on mekaaninen. Isäntä, polku ja resurssimalli vaihtuvat, tarkoitus pysyy. Tässä ennen ja jälkeen kaikkein yleisimmästä kutsusta, tuotteen upsertista:

# 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 '{ "offerId": "SKU-123", "contentLanguage": "en", "feedLabel": "US",
        "productAttributes": { "title": "...", "price": {"amountMicros":"19900000","currencyCode":"EUR"} } }'

(Endpoint-isännät ja ala-API-jako ovat Googlen dokumentaatiosta. Varmista oman resurssisi tarkka pyyntöbody Merchant API -referenssistä ennen julkaisua, sillä kenttien nimet muuttuivat, ei vain URL.)

Määränpää on rehellisesti parempi kuin se, minkä se korvaa, ja juuri sitä kukaan ei kerro. Kolme parannusta, jotka perit migraatiossa ilmaiseksi:

Jos olet pitkään aikonut koventaa feedityökalujasi, sulku on se pakottava sysäys. Rakenna kerran uudelleen ja poistu puhtaammalla virheenkäsittelyllä ja vähemmillä edestakaisilla kutsuilla kuin v2.1 koskaan salli.

Takaraja kaksi: Dynamic Search Ads muuttuu AI Maxiksi syyskuussa 2026

Toinen päivätty muutos, ja se, joka järjestää uusiksi sen, paljonko kontrollia pidät itselläsi.

Mikä muuttui. AI Max for Search saavutti GA:n 15. huhtikuuta 2026 toukokuussa 2025 alkaneen betan jälkeen. Syyskuusta 2026 alkaen Google päivittää automaattisesti AI Maxiksi kaikki jäljellä olevat DSA:t, automaattisesti luodut aineistot ja kampanjatason laajan haun. Sen jälkeen uutta DSA-kampanjaa ei luoda. Ei käyttöliittymässä, ei Editorissa, ei API:ssa.

Miksi se koskee tiliäsi. Kauppa kuuluu: kontrollia kasvua vastaan. Koko ominaisuuspaketilla (hakutermien täsmäytys plus tekstin mukautus plus lopullisen URL:n laajennus) Google raportoi noin +7 % konversioita tai konversioarvoa verrattuna pelkkään täsmäytykseen. Vastineeksi luovutat mallille täsmäytyksen, aineistotekstit ja laskeutumissivun valinnan. Jos brändi- tai compliance-säännöt on rakennettu käsin DSA-asetuksiisi, hiljainen syyskuun päivitys voi alkaa ohjata liikennettä URL-osoitteisiin ja teksteihin, joita et koskaan hyväksynyt. Automaatio, jota et mitannut, on automaatiota, jota et hallitse.

Mitä tehdä. Älä jää odottamaan, mitä päivitys tekee luvuillesi. Mittaa se nyt. Google julkaisi suojakaiteet ja mittauskoukut API:n kautta samassa tahdissa ominaisuuden kanssa, joten voit A/B-testata vaihdon omalla datallasi ennen kuin siitä tulee pakollinen:

Käytännön siirto on viimeinen. Luo ADOPT_AI_MAX-kokeilu tileillesi ja anna sen pyöriä. CPA- ja ROAS-deltan luet vertaamalla kokeiluhaaran kampanjoita kontrolliin. Tavallinen GAQL-haku näyttää sitten, mitä avainsanaton laajennus oikeasti täsmäytti ja tuotti:

-- After ADOPT_AI_MAX runs: inspect automated expansion performance.
-- Calculate trial/control delta separately from the experiment arm campaigns.
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:n uusista kokeilutyypeistä; targeting_expansion_view on v22:n raportointiresurssi. Varmista kenttien saatavuus kutsumasi version release notesista.)

Liukuva takaraja: julkaisu joka kuukausi

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

Mikä muuttui. Versiosta 23 (28. tammikuuta 2026) alkaen Google Ads API siirtyi kuukausittaiseen julkaisutahtiin. Neljä major-versiota vuodessa plus kuukausittaiset minor-versiot, vuoden tuki jokaiselle major-versiolle.

Miksi se koskee tiliäsi. Nopeampi pääsy ominaisuuksiin, ja nopeampi vanheneminen. Versiot vanhenevat julkaistun kalenterin mukaan. v20 saavuttaa elinkaarensa lopun kesäkuussa 2026, v21 elokuussa, v22 lokakuussa. Kuukausittainen minor-korotus ei riko mitään. Ohitettu major-sulku tarkoittaa, että skriptisi alkavat palauttaa virheitä ilman muuta varoitusta kuin päivämäärä kalenterissa, jota et seurannut.

Mitä tehdä. Kiinnitä versiosi ja vahdi sulkukalenteria. Halvin vakuutus on toistuva tarkistus, joka tietää, mitä versiota kutsut, ja hälyttää noin 60 päivää ennen vanhenemista. Koko juttu on muutama rivi:

# 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"}  # 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

404 sammutetusta versiosta on itse aiheutettu katko. Kohtele versionhallintaa pysyvänä toistuvana tehtävänä, älä palokuntaharjoituksena.

Nyt etu: tekoäly muuttaa luovaan työhön ja feediin

Kun takarajat on hoidettu, loppuvuosi on vipuvartta, jonka otat käyttöön omalla aikataulullasi. Kaksi palvelua muutti aineisto- ja feedityön joksikin, jonka voit skriptata tuhansien SKU:iden yli.

• AssetGenerationService (Ads API, v22, suljettu beta). Tekoälyn teksti- ja kuvagenerointi, PMax-kuvien parannus ja poiminta; v23.2 lisäsi VideoEnhancement-ominaisuuden Googlen generoimalle videolle. Luova tuotanto siirtyy käyttöliittymästä ohjelmoitavaan kerrokseen.
• Product Studio (Merchant API, alpha huhtikuusta 2025). Tekoälyn generoimat tuoteotsikot ja -kuvaukset, plus AutomatedDiscounts reaaliaikaiseen hinnoitteluun. Otsikoiden uudelleenkirjoitus API-tasolla tarkoittaa tuhansien SKU:iden parantamista massana ilman käsityötä.

Feed-puolen otan henkilökohtaisesti. Rakensimme Lyntissä kaksi vuotta Boosteraa, tekoälykerrosta, joka rikastaa Merchant Center -feedejä, koska feedin laatu on Shoppingin ja PMaxin suorituskyvyn katto. Paremmat otsikot liikuttavat enemmän liikevaihtoa kuin useimmat hintatarjousmuutokset. Product Studio tuo palan sitä kyvykkyyttä suoraan alustaan.

Pipeline, jonka tämä avaa, lukee SKU:n feedistä, generoi vaatimustenmukaisen otsikon, kuvauksen ja kuva-aineistot ja työntää ne suoraan aineistoryhmään, ilman manuaalista Canva-välivaihetta. Molemmat palvelut ovat pre-GA:ssa. Kohtele niitä pilottina katalogin siivulla, älä koko katalogin käyttöönottona, kunnes ne valmistuvat.

Putkityöt: Ads ja Merchant vihdoin yhdessä

Vuoden aliarvostetuin muutos on epäglamoröösi. Verkkokauppatilin kaksi puoliskoa päätyvät samaan paikkaan.

Mikä muuttui. 22. huhtikuuta 2026 alkaen Merchant API on käytettävissä Google Ads Scriptsistä. Yhdistettynä product_filters-ominaisuuteen (ehdollinen feedin jako Google Adsin kanssa, julkaistu marraskuussa 2025) ja CartDataSalesView-näkymään (v24) silmukka feedin kunnon ja mainoskulujen välillä sulkeutuu yhdessä ympäristössä.

Miksi se koskee tiliäsi. Vanha jako, kampanjat Scriptsissä ja feed hallinnoituna 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 PMaxin listausryhmästä. Ja CartDataSalesView tuo API:in ostoskoridatan tuotot myytyä SKU:ta kohden. Se sisältää tuotot, ei kuluja, joten todellinen SKU-tason ROAS vaatii kaksi kyselyä. Aloita tuottopuolesta:

-- Revenue per sold SKU from cart data (v24+)
SELECT segments.product_item_id,
       metrics.revenue_micros,
       metrics.all_revenue_micros
FROM cart_data_sales_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.revenue_micros DESC

Hae sitten kulupuoli shopping_performance_view-näkymästä ja yhdistä tulokset product_item_id-kentällä:

-- Cost per advertised SKU; join to the revenue query on product_item_id
SELECT segments.product_item_id,
       metrics.cost_micros,
       metrics.conversions_value
FROM shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.cost_micros DESC

Nuo yhdistetyt rivit ovat syöte kannattavuusluokitteluun, jonka ennen rakensit käsin joka kuukausi. Ajamme asiakkaille asiakastason bisnesraportointia BigQueryssa, ja puolet työstä on aina ollut mainosdatan ompelua tuotedataan. Sauma elää nyt kahdessa API-kutsussa feed-exportin sijaan, ja voit validoida sen. Tarkista, että item ID:t täsmäävät molemmilla puolilla, ennen kuin luotat suhdelukuun. (Resurssi on cart_data_sales_view, julkaistu v24:ssä; varmista segmenttien saatavuus oman versiosi release notesista.)

Vuosi yhdellä aikajanalla

Jokainen alla oleva major-versio on virallisista release notesista; Merchant-virstanpylväät Merchant API latest updates -sivulta. Oikea sarake on ainoa, jonka pitäisi ohjata kalenteriasi. Kaikki KOVA-merkitty on ehdotonta.

Ensimmäinen työtunti

Ei koko migraatiota. Grep. Hae koodikannastasi shoppingcontent.googleapis.com ja kirjaa ylös jokainen esiin nouseva job. Se lista on altistuksesi 18. elokuulle, ja se vei sinulta kymmenen minuuttia.

Käytä loppu tunti yhden ADOPT_AI_MAX-kokeilun luomiseen tilillä, jolla DSA painaa eniten, jotta syyskuu saapuu mitattuna muutoksena eikä yllätyksenä. Takarajat ovat Googlen. Se, osuvatko ne sinuun katkoina vai parannuksina, on yhä sinun valintasi.

FAQ