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 kaksitoista vuotta koodia, joka kutsuu tätä API:a, ja suurimman osan siitä ajasta se muuttui niin hitaasti, että siellä saattoi käydä kerran vuodessa, nostaa versionumeroa ja unohtaa koko jutun.

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 on toinen päivämäärä, jota Google on jo siirtänyt: helmikuusta 2027 alkaen jokainen jäljellä oleva Dynamic Search Ads -kampanja päivittyy automaattisesti AI Maxiksi, halusit tai et. Syyskuussa 2026 päivittyvät ensin automaattisesti luodut elementit ja kampanjatason laaja vastaavuus.

Nuo kaksi päivämäärää ovat Googlen API-vuoden velvollisuudet. Kaikki muu, mitä alusta julkaisi, on mahdollisuus: 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, pyyntörunko 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 pyyntörungon 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 julkaistiin GA-versiona heinäkuussa 2025, ja välivaihe v1beta sammui jo 28. helmikuuta 2026. Vanhan monoliitin korvaavat kohdennetut ali-API:t. datasources, products, inventories, reports, notifications.

Miksi se koskee tiliäsi. Kaikki, mikä käsittelee feediäsi 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 ehdoton katkaisupäivä. 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 integraatiosi uudelleen uuden ali-API-rakenteen päälle. Migraatio on mekaaninen. Palvelinosoite, polku ja resurssimalli vaihtuvat, tarkoitus pysyy. Näin kaikkein yleisin kutsu eli tuotteen upsert muuttuu:

# 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-osoitteet ja ali-API-jako ovat Googlen dokumentaatiosta. Varmista oman resurssisi tarkka pyyntörunko Merchant API -referenssistä ennen julkaisua, sillä kenttien nimet muuttuivat, ei vain URL.)

Merchant API v1 on parempi API kuin Content API, jonka se korvaa, ja juuri sitä kukaan ei kerro. Kolme parannusta, jotka perit migraatiossa ilmaiseksi:

Jos olet pitkään aikonut koventaa feedityökalujasi, sulku pakottaa sinut siihen nyt. Rakenna kerran uudelleen, niin jäljelle jää puhtaampi virheenkäsittely ja vähemmän edestakaisia kutsuja kuin v2.1 koskaan salli.

Takaraja kaksi: Dynamic Search Ads muuttuu AI Maxiksi helmikuussa 2027

Tämä on toinen kiinteään päivämäärään sidottu muutos, ja se järjestää uusiksi sen, kuinka paljon päätösvaltaa pidät itselläsi.

Mikä muuttui. AI Max for Search saavutti GA:n 15. huhtikuuta 2026 toukokuussa 2025 alkaneen betan jälkeen. Käyttöönotto tapahtuu kahdessa vaiheessa: syyskuusta 2026 alkaen Google päivittää automaattisesti AI Maxiksi kampanjat, joissa käytetään automaattisesti luotuja elementtejä ja kampanjatason laajaa vastaavuutta, ja DSA:n sulkeminen ja automaattinen päivitys alkavat helmikuussa 2027. Google siirsi jälkimmäisen vaiheen alun perin ilmoittamastaan syyskuusta myöhemmäksi. Sen jälkeen uutta DSA-kampanjaa ei voi enää luoda. Ei käyttöliittymässä, ei Editorissa, ei API:ssa.

Miksi se koskee tiliäsi. Annat kontrollia ja saat vastineeksi tulosta. Koko ominaisuuspaketilla (hakutermivastaavuus plus tekstin muokkaus plus lopullisen URL-osoitteen laajennus) Google raportoi noin +7 % konversioita tai konversioarvoa verrattuna pelkkään hakutermivastaavuuteen. Vastineeksi luovutat mallille hakutermivastaavuuden, tekstin muokkauksen ja lopullisen URL-osoitteen valinnan. Jos brändi- tai compliance-säännöt on rakennettu käsin DSA-asetuksiisi, hiljainen automaattinen päivitys voi alkaa ohjata liikennettä URL-osoitteisiin, joita et ole hyväksynyt. Se voi myös käyttää mainostekstejä, joille et ole antanut hyväksyntää. 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 mittausmahdollisuudet API:n kautta samassa tahdissa ominaisuuden kanssa, joten voit A/B-testata vaihdon omalla datallasi ennen kuin siitä tulee pakollinen:

Käytännön ratkaisu on ADOPT_AI_MAX-kokeilu. Luo sellainen tileillesi ja anna sen pyöriä. CPA- ja ROAS-deltan luet vertaamalla kokeiluhaaran kampanjoita kontrollikampanjoihin. 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 julkaisutiedoista.)

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. Huomaamatta jäänyt 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ä viime hetken hätätapauksena.

Nyt edut: tekoäly tulee luoviin aineistoihin ja feediin

Kun takarajat on hoidettu, voit edetä loppuvuoden omassa tahdissasi. Kaksi palvelua muutti aineisto- ja feedityön sellaiseen muotoon, että voit skriptata sen tuhansille SKU:ille.

• 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ä.

Minulla on tässä feed-puolella henkilökohtainen intressi. Rakensimme Lyntissä kaksi vuotta Boostoraa, tekoälykerrosta, joka rikastaa Merchant Center -feedejä, koska feedin laatu on Shoppingin ja PMaxin suorituskyvyn katto. Paremmat otsikot tuovat enemmän liikevaihtoa kuin useimmat hintatarjousmuutokset. Product Studio tuo palan sitä kyvykkyyttä suoraan alustaan.

Putki, jonka tämä avaa, lukee SKU:n feedistä, generoi vaatimustenmukaisen otsikon, kuvauksen ja kuvaelementit ja työntää ne suoraan elementtiryhmään, ilman manuaalista Canva-välivaihetta. Molemmat palvelut ovat pre-GA:ssa. Kohtele niitä pilottina osalla katalogia, älä koko katalogin käyttöönottona, kunnes ne ovat GA-vaiheessa.

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ä. Yhdistä tähän product_filters (ehdollinen feedin jako Google Adsin kanssa, julkaistu marraskuussa 2025) ja CartDataSalesView (v24), niin silmukka feedin tilasta mainoskuluihin sulkeutuu yhdessä ympäristössä.

Miksi se koskee tiliäsi. Vanha jako piti kampanjat Scriptsissä ja feedin jossain muualla. 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 niihin kannattavuustasoihin, jotka ennen rakensit käsin joka kuukausi. Ajamme asiakkaille asiakastason liiketoimintaraportointia BigQueryssa, ja puolet työstä on aina ollut mainosdatan ompelua tuotedataan. Kaksi API-kutsua hoitaa nyt sen ompelun, joka ennen vaati feed-viennin, ja voit varmistaa tuloksen itse. Tarkista, että item ID:t täsmäävät molemmissa kyselyissä, ennen kuin luotat suhdelukuun. (Resurssi on cart_data_sales_view, julkaistu v24:ssä; varmista segmenttien saatavuus oman versiosi julkaisutiedoista.)

Vuosi yhdellä aikajanalla

Jokainen alla oleva major-versio on virallisista julkaisutiedoista; Merchant-virstanpylväät Merchant API latest updates -sivulta. Oikea sarake on ainoa, jonka pitäisi ohjata kalenteriasi. Jokainen HARD-merkinnän saanut rivi on ehdoton.

Ensimmäinen työtunti

Ei koko migraatiota. Grep. Hae koodikannastasi shoppingcontent.googleapis.com ja kirjaa ylös jokainen esiin nouseva job. Se lista on kaikki, mikä sinulla on vaarassa 18. elokuuta, ja se vei sinulta kymmenen minuuttia.

Käytä loppu tunti yhden ADOPT_AI_MAX-kokeilun luomiseen tilillä, jolla DSA painaa eniten, jotta päivityksestä tulee mitattu muutos eikä yllätys. Takarajat ovat Googlen. Se, osuvatko ne sinuun katkoina vai parannuksina, on yhä sinun valintasi.

FAQ