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, který tohle API volá, a většinu té doby se měnilo tak pomalu, že ses na něj podíval jednou ročně, zvedl číslo verze a zase na něj 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. Za ním je druhé datum, které už Google posunul: od února 2027 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. V září 2026 přijdou jako první na řadu automaticky vytvářené assety a volná shoda na úrovni kampaně.

Ta dvě data jsou tvoje povinnosti v letošním roce s Google Ads API. 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.

Nezůstanu 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 rozejde s realitou, 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řepiš svou integraci na novou strukturu sub-API. Migrace je mechanická. Mění se host, cesta a model zdrojů, záměr zůstává. Tady je stav před a po u nejběžnějšího volání ze všech, u upsertu 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ěř v referenci Merchant API, protože se změnily názvy polí, ne jen URL.)

Merchant API v1 nastupuje na místo Content API a je to lepší API. Přesně tohle ti nikdo neřekne. Tři vylepšení, která migrací zdědíš zadarmo:

Pokud ses dlouho chystal zpevnit svoje feedové nástroje, vypnutí je to, co tě k tomu konečně donutí. Přepiš to jednou a odejdeš s čistším ošetřením chyb a menším počtem volání tam a zpět, než kolik jich v2.1 kdy dovolila.

Termín číslo dva: dynamické reklamy se v únoru 2027 mění na AI Max

Tohle je druhá změna s pevným datem a přeskládá, kolik kontroly ti zůstane 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. Přechod proběhne ve dvou krocích: od září 2026 Google automaticky upgraduje kampaně s automaticky vytvářenými assety a volnou shodou na úrovni kampaně; konec DSA i jejich automatický upgrade začnou v únoru 2027, protože je Google posunul z původně oznámeného zářijového termínu. Pak už novou DSA kampaň nevytvoříš. Ne v UI, ne v Editoru, ne přes API.

Proč se to týká tvého účtu. Měníš kontrolu 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í dotazů. Na oplátku modelu přenecháváš 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ý automatický upgrade může začít posílat provoz na URL, které jsi nikdy neodsouhlasil, a používat u toho reklamní 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 do API pojistky i měřicí body souběžně s funkcí, takže si přepnutí můžeš A/B otestovat na vlastních datech, než bude povinné:

Praktický tah je ADOPT_AI_MAX experiment. Vytvoř ho 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 kontrolními kampaněmi. 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ěř v 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 z vypnuté verze je výpadek, který sis způsobil sám. Ber správu verzí jako stálý opakovaný úkol, ne jako něco, co se řeší na poslední chvíli.

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

S vyřešenými termíny běží zbytek roku tempem, které si určíš sám. 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). Generování textů a obrázků pomocí AI, 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). Názvy a popisy produktů generované AI plus AutomatedDiscounts pro ceny v reálném čase. Přepisování názvů na úrovni API znamená hromadné zlepšení tisíců SKU bez ruční práce.

Feedová polovina je pro mě osobní věc. V Lyntu jsme dva roky stavěli Boostoru, AI vrstvu, která obohacuje feedy v Merchant Center, protože kvalita feedu je strop výkonu Shoppingu a PMaxu. Lepší názvy přinesou víc tržeb než většina úprav nabídek. 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í název, 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 nebudou v GA.

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. Zkombinuj to s product_filters (podmíněné sdílení feedu s Google Ads, vydáno v listopadu 2025) a CartDataSalesView (v24) a smyčka od stavu feedu k útratě za reklamu se uzavře v jednom prostředí.

Proč se to týká tvého účtu. Staré rozdělení drželo kampaně ve Scripts a feed někde úplně jinde. Zamítnutý produkt pálil rozpočet dál, 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 na úrovni jednotlivých prodaných SKU. Nese ale jen tržby, ne útratu, takže skutečný ROAS na 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 pásem ziskovosti, 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 byla vždycky slepování reklamních dat s produktovými. Dva API dotazy teď zvládnou slepení, na které dřív padl export feedu, a výsledek si sám ověříš. Než poměru uvěříš, zkontroluj, že item ID sedí v obou dotazech. (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; milníky Merchantu z Merchant API latest updates. Jediný sloupec, který má řídit tvůj kalendář, je ten pravý. Každý řádek s příznakem HARD je nesmlouvavý.

První hodina práce

Ne celá migrace. Grep. Vyhledej v kódu shoppingcontent.googleapis.com a zapiš si každý job, který vyskočí. Ten seznam ukazuje, co všechno máš k 18. srpnu v ohrožení, 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 upgrade přišel 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