Rok s Google Ads API: dva tvrdé termíny, zbytek je příležitost

V lednu Google vydal v23 Ads API a oznámil, že od té chvíle bude nová verze vycházet každý měsíc. Četl jsem to dvakrát. Dvanáct let píšu kód proti tomuhle API a většinu té doby to byl pomalý povrch, který jsi navštívil jednou ročně, zvedl číslo verze a zapomněl.

Pak jsem udělal to, co mě ta léta naučila. Otevřel jsem náš kód v Lyntu a vyhledal shoppingcontent.googleapis.com. Každý nález je skript, který umře 18. srpna 2026, v den, kdy se vypíná Content API for Shopping. Hned za ním sedí druhé datum. V září 2026 se každá zbývající kampaň s dynamickými reklamami ve vyhledávání automaticky upgraduje na AI Max, ať o to stojíš, nebo ne.

Tyhle dvoje hodiny jsou povinnosti googlího API roku. Všechno ostatní, co platforma vydala, je příležitost. AI služby pro kreativu, reporting prodejů na úrovni produktu, Merchant API uvnitř Google Ads Scripts. Projdu ten rok podle priority, nejtvrdší termín první. U každé změny co to je, proč se týká tvého účtu a jaké přesné volání, payload nebo migraci spustit.

Nenechám nic u „měl bys migrovat”. Termín bez konkrétního artefaktu je jen úzkost. Na každém kroku dostaneš endpoint, který nahrazuje ten starý, payload experimentu nebo GAQL dotaz, takže přesně vidíš, co postavit, než to datum přijde.

Termín číslo jedna: Content API for Shopping umírá 18. srpna 2026

Tohle je nejtvrdší datum roku, takže jde první.

Co se změnilo. Content API for Shopping v2.1 se vypíná 18. srpna 2026. Jeho nástupce, Merchant API v1, je GA od července 2025, a mezikrok v1beta už skončil 28. února 2026. Starý monolit nahrazují zaměřená sub-API. datasources, products, inventories, reports, notifications.

Proč se to týká tvého účtu. Cokoli, co sahá na tvůj feed přes staré API, tím dnem přestane fungovat. Nahrávání feedů, doplňkové feedy, vlastní štítky, aktualizace cen a skladu, čtení zamítnutí. Tohle není „hodilo by se zmigrovat”, je to tvrdý konec. Pokud ti denní skript synchronizuje ceny, 18. srpna zmlkne a feed se pomalu rozjede od reality, dokud si někdo nevšimne ztracených tržeb. Tenhle způsob selhání jsem na reálných účtech viděl a drahá není samotná odstávka, drahé jsou týdny, kdy si jí nikdo nevšimne.

Co udělat. Přestav to proti struktuře sub-API. Migrace je mechanická. Mění se host, cesta a model zdrojů, záměr zůstává. Tady je před a po pro nejběžnější volání ze všech, upsert produktu:

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

(Hosty endpointů a rozdělení na sub-API jsou z dokumentace Googlu. Přesné tělo requestu pro svůj zdroj si před nasazením ověř proti referenci Merchant API, protože se změnily názvy polí, ne jen URL.)

Cíl je upřímně lepší než to, co nahrazuje, což je ta část, kterou ti nikdo neřekne. Tři vylepšení, která migrací zdědíš zadarmo:

Pokud ses dlouho chystal zpevnit svoje feedové nástroje, vypnutí je ta vynucená příležitost. Přestav to jednou a odejdi s čistším error handlingem a menším počtem round-tripů, než v2.1 kdy dovolilo.

Termín číslo dva: dynamické reklamy se v září 2026 mění na AI Max

Druhá datovaná změna a ta, která přeskládá, kolik kontroly držíš v rukou.

Co se změnilo. AI Max for Search dosáhl GA 15. dubna 2026 po betě spuštěné v květnu 2025. Od září 2026 Google automaticky upgraduje všechny zbývající DSA, automaticky vytvářené assety a volnou shodu na úrovni kampaně na AI Max. Pak už novou DSA kampaň nevytvoříš. Ne v UI, ne v Editoru, ne přes API.

Proč se to týká tvého účtu. Obchod zní kontrola za růst. S plnou sadou funkcí (párování dotazů plus úprava textů plus expanze finálních URL) Google uvádí zhruba +7 % konverzí nebo hodnoty konverzí oproti samotnému párování. Výměnou dáváš modelu párování, texty assetů i volbu cílové stránky. Pokud máš brandová nebo compliance pravidla ručně zadrátovaná v DSA setupu, tichý zářijový upgrade může začít posílat provoz na URL a texty, které jsi nikdy neschválil. Automatizace, kterou jsi nezměřil, je automatizace, kterou neřídíš.

Co udělat. Nečekej, co upgrade udělá s tvými čísly. Změř to teď. Google vydal zábradlí i měřicí háčky v API souběžně s funkcí, takže si přepnutí můžeš A/B otestovat na vlastních datech, než bude povinné:

Praktický tah je ten poslední. Vytvoř ADOPT_AI_MAX experiment napříč účty a nech ho běžet. Rozdíl CPA a ROAS si přečteš porovnáním kampaní experimentální větve s kontrolou. Běžný GAQL dotaz ti pak ukáže, co expanze bez klíčových slov reálně spárovala a vydělala:

-- 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 je jeden z nových typů experimentů z v24.1; targeting_expansion_view je reportovací zdroj z v22. Dostupnost polí si ověř proti release notes pro verzi, kterou voláš.)

Klouzavý termín: vydání každý měsíc

Ne jedno datum, ale hodiny, které teď tikají pořád.

Co se změnilo. Od v23 (28. ledna 2026) Google Ads API přešlo na měsíční kadenci vydání. Čtyři major verze ročně plus měsíční minor verze, s rokem podpory na každou major verzi.

Proč se to týká tvého účtu. Rychlejší přístup k funkcím a rychlejší zastarávání. Verze dožívají podle zveřejněného kalendáře. v20 končí v červnu 2026, v21 v srpnu, v22 v říjnu. Měsíční minor bump nic nerozbíjí. Prošvihnutý sunset major verze znamená, že skripty začnou vracet chyby bez jiného varování než data v kalendáři, který jsi nesledoval.

Co udělat. Připni si verzi a hlídej sunset kalendář. Nejlevnější pojistka je opakovaná kontrola, která ví, jakou verzi voláš, a ozve se zhruba 60 dní před vypršením. Celé je to pár řádků:

# 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 ze sunsetnuté verze je výpadek, který sis způsobil sám. Ber správu verzí jako stálý opakovaný úkol, ne jako hasičské cvičení.

A teď bonus: AI se stěhuje do kreativy a feedu

S vyřešenými termíny je zbytek roku páka, kterou nasadíš podle vlastního kalendáře. Dvě služby proměnily práci s assety a feedem v něco, co naskriptuješ přes tisíce SKU.

• AssetGenerationService (Ads API, v22, uzavřená beta). AI generování textů a obrázků, s vylepšením a extrakcí obrázků pro PMax; v23.2 přidala VideoEnhancement pro video generované Googlem. Tvorba kreativy se stěhuje z UI do programovatelné vrstvy.
• Product Studio (Merchant API, alpha od dubna 2025). AI generované názvy a popisy produktů plus AutomatedDiscounts pro ceny v reálném čase. Přepisování titulků na úrovni API znamená hromadné zlepšení tisíců SKU bez ruční práce.

Feedovou polovinu si beru osobně. V Lyntu jsme dva roky stavěli Boosteru, AI vrstvu, která obohacuje feedy v Merchant Center, protože kvalita feedu je strop výkonu Shoppingu a PMaxu. Lepší titulky pohnou tržbami víc než většina úprav bidů. Product Studio přináší kus téhle schopnosti přímo do platformy.

Pipeline, kterou to odemyká, přečte SKU z feedu, vygeneruje vyhovující titulek, popis a obrázkové assety a pošle je rovnou do asset group, bez ručního mezikroku v Canvě. Obě služby jsou pre-GA. Ber je jako pilot na výseku katalogu, ne jako celokatalogový rollout, dokud nedospějí.

Instalatérina: Ads a Merchant konečně u sebe

Nejpodceňovanější změna roku je neokázalá. Dvě poloviny e-commerce účtu končí na jednom místě.

Co se změnilo. Od 22. dubna 2026 je Merchant API dostupné z Google Ads Scripts. V kombinaci s product_filters (podmíněné sdílení feedu s Google Ads, vydáno v listopadu 2025) a CartDataSalesView (v24) se smyčka mezi zdravím feedu a útratou za reklamu uzavírá v jednom prostředí.

Proč se to týká tvého účtu. Staré rozdělení, kampaně ve Scripts a feed spravovaný jinde, znamenalo, že zamítnutý produkt pálil rozpočet, dokud si toho nevšiml člověk. Teď může jeden skript na zamítnutí ve feedu zareagovat pauzou kampaně nebo vyřazením SKU z listing group v PMaxu. A CartDataSalesView přináší do API tržby z košíku po prodaných SKU. Nese ale jen tržby, ne útratu, takže skutečný ROAS po SKU znamená dva dotazy. Začni stranou tržeb:

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

Pak vytáhni stranu nákladů ze shopping_performance_view a oba výsledky spoj přes 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

Tyhle spojené řádky jsou vstup do ziskovostního tieringu, který jsi dřív každý měsíc skládal ručně. Pro klienty stavíme business reporting v BigQuery na úrovni zákazníka a půlka práce bylo vždycky slepování reklamních dat s produktovými. Ten šev teď žije ve dvou API dotazech místo exportu feedu a dá se zvalidovat. Než poměru uvěříš, zkontroluj, že item ID sedí na obou stranách. (Zdroj je cart_data_sales_view z v24; dostupnost segmentů si ověř v release notes své verze.)

Rok na jedné časové ose

Každá major verze níže pochází z oficiálních release notes; merchant milníky z Merchant API latest updates. Jediný sloupec, který má řídit tvůj kalendář, je ten pravý. Všechno označené TVRDÉ je nesmlouvavé.

První hodina práce

Ne celá migrace. Grep. Prohledej svůj kód na shoppingcontent.googleapis.com a zapiš si každý job, který vyskočí. Ten seznam je tvoje expozice k 18. srpnu a zabral ti deset minut.

Zbytek hodiny věnuj vytvoření jednoho ADOPT_AI_MAX experimentu na účtu, kde DSA hraje největší roli, aby září přišlo jako změřená změna, ne jako překvapení. Termíny patří Googlu. Jestli tě zasáhnou jako výpadky, nebo jako upgrady, je pořád tvoje volba.

FAQ