Godina s Google Ads API-jem: dva tvrda roka, ostalo je prilika

U siječnju je Google objavio v23 Ads API-ja i najavio da će od tada nova verzija izlaziti svaki mjesec. Pročitao sam to dvaput. Dvanaest godina pišem kod koji poziva ovaj API i većinu tog vremena API se mijenjao dovoljno sporo da si u njega zavirio jednom godišnje, podigao broj verzije i opet ga zaboravio.

Onda sam učinio ono što su me te godine naučile. Otvorio sam naš kod u Lyntu i potražio shoppingcontent.googleapis.com. Svaki pogodak je skripta koja umire 18. kolovoza 2026., na dan kada se gasi Content API for Shopping. Iza njega je drugi datum, koji je Google već pomaknuo: od veljače 2027. svaka preostala Dynamic Search Ads kampanja automatski prelazi na AI Max, htio ti to ili ne. U rujnu 2026. prvo prelaze automatski stvoreni elementi i široko podudaranje na razini kampanje.

Ta su dva datuma obveze ove godine s Google Ads API-jem. Sve ostalo što je platforma isporučila prilika je: AI servisi za kreative, izvještavanje o prodaji na razini proizvoda, Merchant API unutar Google Ads Scriptsa. Zato ću godinu proći po prioritetu, najtvrđi rok prvi. Za svaku promjenu: što je, zašto se tiče tvog računa i koji točno poziv, payload ili migraciju pokrenuti.

Ništa neću ostaviti na „trebao bi migrirati”. Rok bez konkretnog artefakta samo je tjeskoba. Na svakom koraku dobivaš endpoint koji zamjenjuje stari, payload eksperimenta ili GAQL upit, pa točno vidiš što izgraditi prije nego datum stigne.

Rok broj jedan: Content API for Shopping umire 18. kolovoza 2026.

Ovo je najtvrđi datum godine, pa ide prvi.

Što se promijenilo. Content API for Shopping v2.1 gasi se 18. kolovoza 2026. Njegov nasljednik, Merchant API v1, u GA-u je od srpnja 2025., a međukorak v1beta već je ugašen 28. veljače 2026. Stari monolit zamjenjuju fokusirani pod-API-ji. datasources, products, inventories, reports, notifications.

Zašto se tiče tvog računa. Sve što dira tvoj feed kroz stari API tog dana prestaje raditi. Slanje feedova, dopunski feedovi, prilagođene oznake, ažuriranja cijena i zaliha, čitanje odbijanja. Ovo nije „bilo bi zgodno migrirati”, ovo je tvrdi rez. Ako ti dnevna skripta sinkronizira cijene, 18. kolovoza zanijemi, a feed se polako razilazi sa stvarnošću dok netko ne primijeti izgubljeni prihod. Vidio sam taj obrazac kvara na stvarnim računima i najveći trošak nije sam ispad, nego to što ga tjednima nitko ne primijeti.

Što učiniti. Prepiši svoju integraciju na novu strukturu pod-API-ja. Migracija je mehanička. Mijenjaju se host, putanja i model resursa, namjera ostaje. Evo stanja prije i poslije za najčešći poziv od svih, za upsert proizvoda:

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

(Hostovi endpointa i podjela na pod-API-je dolaze iz Googleove dokumentacije. Točan body zahtjeva za svoj resurs provjeri prije objave u referenci Merchant API-ja, jer su se promijenili nazivi polja, a ne samo URL.)

Merchant API v1 bolji je API od Content API-ja koji zamjenjuje, i upravo to ti nitko ne kaže. Tri poboljšanja koja migracijom nasljeđuješ besplatno:

Ako se odavno spremaš ojačati svoje alate za feedove, gašenje je ono što će te konačno natjerati da to i napraviš. Prepiši jednom i izaći ćeš s čišćim rukovanjem greškama i manjim brojem poziva u oba smjera nego što ih je v2.1 ikad dopuštao.

Rok broj dva: Dynamic Search Ads u veljači 2027. postaje AI Max

Ovo je druga promjena s čvrstim datumom i preslaguje koliko kontrole zadržavaš.

Što se promijenilo. AI Max for Search dosegao je GA 15. travnja 2026. nakon beta lansiranja u svibnju 2025. Uvođenje ide u dva koraka: od rujna 2026. Google automatski prebacuje kampanje koje upotrebljavaju automatski stvorene elemente i široko podudaranje na razini kampanje, a gašenje i automatski prelazak samih DSA-a počinju u veljači 2027., nakon što ih je Google odgodio s prvotno najavljenog rujanskog datuma. Nakon toga novu DSA kampanju više ne stvaraš. Ni u sučelju, ni u Editoru, ni preko API-ja.

Zašto se tiče tvog računa. Mijenjaš kontrolu za rast. S punim skupom funkcija (podudaranje korisničkih upita plus prilagodba teksta plus proširenje završnih URL-ova) Google navodi oko +7 % konverzija ili vrijednosti konverzija u odnosu na samo podudaranje korisničkih upita. Zauzvrat modelu predaješ podudaranje, tekstove elemenata i izbor odredišne stranice. Ako imaš pravila brenda ili pravila usklađenosti ručno ugrađena u svoje DSA postavke, tihi automatski prelazak može početi slati promet na URL-ove koje nikad nisi odobrio i pritom koristiti tekst oglasa koji nisi odobrio. Automatizacija koju nisi izmjerio automatizacija je koju ne kontroliraš.

Što učiniti. Ne čekaj da vidiš što će prelazak napraviti tvojim brojkama. Izmjeri to sada. Google je zaštitne mehanizme i mjerne točke kroz API isporučio usporedno s funkcijom, pa prelazak možeš A/B testirati na vlastitim podacima prije nego postane obavezan:

Praktični potez je eksperiment ADOPT_AI_MAX. Stvori ga na svojim računima i pusti da radi. Deltu CPA-a i ROAS-a čitaš usporedbom kampanja eksperimentalne grane s kontrolnim kampanjama. Običan GAQL upit zatim ti pokaže što je proširenje bez ključnih riječi stvarno uparilo i zaradilo:

-- 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 jedan je od novih tipova eksperimenata iz v24.1; targeting_expansion_view resurs je za izvještavanje iz v22. Dostupnost polja provjeri u bilješkama izdanja za verziju koju pozivaš.)

Klizni rok: izdanje svaki mjesec

Ne jedan datum, nego sat koji sada otkucava stalno.

Što se promijenilo. Od v23 (28. siječnja 2026.) Google Ads API prešao je na mjesečni ritam izdanja. Četiri major verzije godišnje plus mjesečne minor verzije, s godinom podrške po major verziji.

Zašto se tiče tvog računa. Brži pristup funkcijama i brže zastarijevanje. Verzije istječu prema objavljenom kalendaru. v20 dolazi do kraja životnog vijeka u lipnju 2026., v21 u kolovozu, v22 u listopadu. Mjesečni minor skok ništa ne lomi. Propušteno gašenje major verzije znači da ti skripte počinju vraćati greške bez ikakvog upozorenja osim datuma u kalendaru koji nisi pratio.

Što učiniti. Prikvači svoju verziju i prati kalendar gašenja. Najjeftinije osiguranje je ponavljajuća provjera koja zna koju verziju pozivaš i javi se oko 60 dana prije isteka te verzije. Sve stane u nekoliko redaka:

# 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

Ako ugašena verzija počne vraćati 404, taj si ispad skrivio sam. Tretiraj upravljanje verzijama kao stalni ponavljajući zadatak, a ne kao nešto što rješavaš u zadnji čas.

A sada prilika: AI se useljava u kreative i feed

S riješenim rokovima, ostatak godine teče tempom koji odrediš. Dva servisa pretvorila su posao s elementima i feedom u nešto što skriptiraš na tisućama SKU-ova.

• AssetGenerationService (Ads API, v22, zatvorena beta). Tekstovi i slike koje generira AI, s poboljšanjem i izvlačenjem slika za PMax; v23.2 dodala je VideoEnhancement za video koji generira Google. Izrada kreativa seli se iz sučelja u programabilni sloj.
• Product Studio (Merchant API, alpha od travnja 2025.). Naslovi i opisi proizvoda koje generira AI, plus AutomatedDiscounts za cijene u stvarnom vremenu. Prepisivanje naslova na razini API-ja znači masovno poboljšanje tisuća SKU-ova bez ručnog rada.

Polovica koja se tiče feedova za mene je osobna stvar. U Lyntu smo dvije godine gradili Boostoru, AI sloj koji obogaćuje feedove Merchant Centera, jer kvaliteta feeda određuje gornju granicu učinka Shoppinga i PMaxa. Bolji naslovi donose više prihoda nego većina promjena licitacija. Product Studio unosi dio te sposobnosti izravno u platformu.

Pipeline koji ovo otključava čita SKU iz feeda, generira usklađen naslov, opis i slikovne elemente i gura ih ravno u grupu elemenata, bez ručnog zaustavljanja u Canvi usput. Oba servisa su pre-GA. Tretiraj ih kao pilot na dijelu kataloga, a ne kao rollout na cijeli katalog, dok ne dođu u GA.

Povezivanje sustava: Ads i Merchant napokon zajedno

Najpodcijenjenija promjena godine posve je neglamurozna. Dvije polovice e-commerce računa završavaju na jednom mjestu.

Što se promijenilo. Od 22. travnja 2026. Merchant API dostupan je iz Google Ads Scriptsa. Spoji to s product_filters (uvjetno dijeljenje feeda s Google Adsom, izdano u studenom 2025.) i CartDataSalesView (v24) pa se petlja od stanja feeda do potrošnje na oglase zatvara u jednom okruženju.

Zašto se tiče tvog računa. Stara podjela držala je kampanje u Scriptsu, a feed negdje drugdje. Odbijeni proizvod nastavljao je paliti proračun dok to čovjek ne bi primijetio. Sada jedna skripta može reagirati na odbijanje u feedu pauziranjem kampanje ili izbacivanjem SKU-a iz PMax grupe proizvoda. A CartDataSalesView unosi u API prihod po prodanom SKU-u iz podataka o košarici. Nosi prihod, ne potrošnju, pa stvarni ROAS po SKU-u traži dva upita. Kreni od strane prihoda:

-- 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

Zatim povuci stranu troškova iz shopping_performance_view i spoji oba rezultata preko product_item_id:

-- 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

Ti spojeni retci ulaz su u razrede profitabilnosti koje si prije svaki mjesec slagao ručno. Za klijente vodimo poslovno izvještavanje na razini kupca u BigQueryju i pola posla oduvijek je bilo šivanje oglasnih podataka s podacima o proizvodima. Šivanje koje je nekad tražilo izvoz feeda sada odrađuju dva poziva API-ja, a rezultat možeš sam provjeriti. Provjeri da se item ID-jevi poklapaju u oba upita prije nego što povjeruješ omjeru. (Resurs je cart_data_sales_view, izdan u v24; dostupnost segmenata provjeri u bilješkama izdanja za svoju verziju.)

Godina na jednoj vremenskoj crti

Svaka major verzija ispod dolazi iz službenih bilješki izdanja; prekretnice Merchanta iz Merchant API latest updates. Desni stupac jedini je koji bi trebao voditi tvoj kalendar. Nijedan redak koji nosi oznaku HARD nije stvar pregovora.

Prvi sat posla

Ne cijela migracija. Grep. Potraži u kodu shoppingcontent.googleapis.com i zapiši svaki job koji iskoči. Taj popis pokazuje sve što ti je 18. kolovoza ugroženo, a oduzeo ti je deset minuta.

Ostatak sata posveti stvaranju jednog eksperimenta ADOPT_AI_MAX na računu gdje DSA znači najviše, da prelazak stigne kao izmjerena promjena, a ne kao iznenađenje. Rokovi pripadaju Googleu. Hoće li te pogoditi kao ispadi ili kao nadogradnje, i dalje je tvoj izbor.

FAQ