Co zmieniło się w tym roku w API Google — i co dokładnie z tym zrobić

Cały rok w jednym zdaniu

Dwa datowane terminy rozłożą twój stack, jeśli je zignorujesz — Content API for Shopping zostanie wyłączone 18 sierpnia 2026, a Dynamic Search Ads zostaną automatycznie przełączone na AI Max we wrześniu 2026 — a trzecia zmiana, nowy miesięczny cykl wydań, po cichu starzeje twoją wersję API szybciej niż dotąd. Cała reszta, którą Google dostarczył w tym roku, to szansa, nie obowiązek. Ten tekst przechodzi przez każdą zmianę tak samo: co się zmieniło, dlaczego ma znaczenie dla twojego konta i jakie dokładnie wywołanie, payload albo migrację uruchomić — w kolejności priorytetów, najtwardszy termin pierwszy.

Nie zostawię żadnego punktu na „powinieneś zmigrować”. Przy każdym kroku jest konkretny artefakt — endpoint, który zastępuje stary, payload eksperymentu, zapytanie GAQL — żebyś dokładnie widział, co zbudować, zanim nadejdzie data.

Słowo o tym, dlaczego to w ogóle ma znaczenie. Przez lata Google Ads i Merchant API były powolną powierzchnią, której dotykałeś raz do roku. To się skończyło. Platforma wydaje teraz co miesiąc, dwie z jej największych powierzchni są wyłączane, a kontrola, którą kiedyś trzymałeś w ręku, przechodzi do modeli. Konta, które wyjdą z tego na plus, to te, które potraktowały ten rok jako projekt migracji, a nie utrzymania.

Termin #1 — Content API for Shopping → Merchant API (18 sierp. 2026)

To najtwardsza data roku, więc idzie pierwsza.

Co się zmieniło. Content API for Shopping v2.1 zostaje wyłączone 18 sierpnia 2026. Jego następca, Merchant API v1, trafiło do GA w lipcu 2025, a pośrednia wersja v1beta została już wyłączona 28 lutego 2026. Stary monolit zastępują skupione sub-API — datasources, products, inventories, reports, notifications.

Dlaczego ma znaczenie dla twojego konta. Wszystko, co dotyka twojego feedu przez stare API, przestaje działać tego dnia: wgrywanie feedów, feedy uzupełniające, etykiety niestandardowe, aktualizacje cen i stanów magazynowych, odczyty odrzuceń. To nie „miło byłoby zmigrować” — to twardy cut-off. Jeśli codzienny skrypt utrzymuje synchronizację twoich cen, 18 sierpnia milknie, a feed powoli traci aktualność, aż ktoś zauważy utracony przychód.

Co zrobić. Przebuduj wszystko pod strukturę sub-API. Kształt migracji jest mechaniczny — zmienia się host, ścieżka i model zasobów, intencja zostaje ta sama. Oto przed/po dla najczęstszego wywołania, 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 '{ "channel": "ONLINE", "offerId": "SKU-123", "contentLanguage": "en", "feedLabel": "US",
        "attributes": { "title": "...", "price": {"amountMicros":"19900000","currencyCode":"EUR"} } }'

(Hosty endpointów i podział na sub-API pochodzą z dokumentacji Google; potwierdź dokładne body żądania dla swojego zasobu w Merchant API reference, zanim wdrożysz — zmieniły się nazwy pól, nie tylko URL.)

Cel jest naprawdę lepszy niż to, co zastępuje — i o tym akurat nikt ci nie mówi. Trzy usprawnienia, które dziedziczysz za darmo dzięki migracji:

Jeśli planowałeś utwardzić swoje narzędzia do feedów, wyłączenie jest funkcją wymuszającą: przebuduj raz i wyjdź z czystszą obsługą błędów i mniejszą liczbą round-tripów, niż v2.1 kiedykolwiek pozwalało.

Termin #2 — Dynamic Search Ads → AI Max (wrzesień 2026)

Druga datowana zmiana — i ta, która przebudowuje to, ile kontroli trzymasz.

Co się zmieniło. AI Max for Search osiągnęło GA 15 kwietnia 2026 po starcie w wersji beta w maju 2025. Od września 2026 Google automatycznie przełącza wszystkie pozostałe DSA, automatycznie tworzone komponenty i dopasowanie przybliżone na poziomie kampanii na AI Max. Potem nie utworzysz już nowej kampanii DSA — ani w interfejsie, ani w Edytorze, ani przez API.

Dlaczego ma znaczenie dla twojego konta. Wymiana to kontrola za wzrost. Z pełnym zestawem funkcji — dopasowanie po wyszukiwanym haśle plus personalizacja tekstu plus rozszerzanie finalnego URL — Google raportuje około +7 % konwersji lub wartości konwersji w stosunku do samego dopasowania po haśle. W zamian oddajesz modelowi dopasowanie, tekst komponentów i wybór landing URL. Jeśli masz reguły marki albo zgodności wpisane w konfigurację DSA ręcznie, cichy wrześniowy upgrade może niepostrzeżenie zacząć kierować ruch na adresy URL i teksty, których nie zatwierdziłeś.

Co zrobić. Nie czekaj, aż się dowiesz, co upgrade zrobi z twoimi liczbami — zmierz to teraz. Google dostarczył zabezpieczenia i haki pomiarowe przez API równolegle z funkcją, więc możesz przetestować przełączenie A/B na własnych danych, zanim stanie się obowiązkowe:

Praktyczny ruch to ten ostatni: utwórz eksperyment ADOPT_AI_MAX na kontach, daj mu działać, a potem odczytaj realną różnicę normalnym zapytaniem GAQL — zamiast dowiadywać się po tym, jak upgrade stanie się nieodwracalny:

-- After ADOPT_AI_MAX runs: read the keywordless match, then the trial delta
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 to jeden z nowych typów eksperymentów dostarczonych w v24.1; targeting_expansion_view to zasób raportowy z v22. Potwierdź dostępność pól w release notes dla wersji, którą wywołujesz.)

Termin #3 (kroczący) — miesięczne wydania, krótszy okres przydatności

To nie jedna data, lecz zegar, który teraz zawsze tyka.

Co się zmieniło. Od v23 (28 stycznia 2026) Google Ads API przeszło na miesięczny cykl wydań: cztery wersje major w roku plus miesięczne wersje minor, z rokiem wsparcia na każdą wersję major.

Dlaczego ma znaczenie dla twojego konta. Szybszy dostęp do funkcji i szybsze starzenie się. Wersje wygasają według opublikowanego harmonogramu — v20 osiąga end-of-life w czerwcu 2026, v21 w sierpniu, v22 w październiku. Miesięczny bump minor jest non-breaking; przegapienie wyłączenia wersji major oznacza, że twoje skrypty zaczynają zwracać błędy bez ostrzeżenia poza datą w kalendarzu, którego nie obserwowałeś.

Co zrobić. Przypnij swoją wersję i obserwuj kalendarz wyłączeń. Najtańsza polisa to cykliczny check, który wie, którą wersję wywołujesz, i alarmuje ~60 dni przed jej wygaśnięciem — API samo zwraca wersję żądania, więc check to kilka linijek:

# 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"}  # from 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 wyłączonej wersji to awaria, którą sam sobie zafundowałeś. Traktuj zarządzanie wersjami jako stałe zadanie cykliczne, a nie alarm przeciwpożarowy.

Teraz przewaga — AI wchodzi w kreację i feed

Z terminami pod kontrolą reszta roku to dźwignia, którą adoptujesz we własnym tempie. Dwie usługi zamieniły pracę z komponentami i feedem w coś, co możesz oskryptować na tysiącach SKU:

• AssetGenerationService — Ads API, v22, closed beta: generowanie tekstu i obrazów przez AI, z ulepszaniem i ekstrakcją obrazów dla PMax; v23.2 dodała VideoEnhancement dla wideo generowanego przez Google. Generowanie kreacji wychodzi z interfejsu do warstwy programowalnej.
• Product Studio — Merchant API, alpha od kwietnia 2025: generowane przez AI tytuły i opisy produktów, plus AutomatedDiscounts do wyceny w czasie rzeczywistym. Jakość feedu to sufit skuteczności Shopping i PMax, więc przepisywanie tytułów na poziomie API oznacza masowe ulepszanie tysięcy SKU bez pracy ręcznej.

Konkretny pipeline, który to odblokowuje: odczytaj SKU z feedu → wygeneruj zgodny tytuł/opis i komponenty graficzne → wepchnij je prosto do grupy plików, bez ręcznego kroku w Canvie po drodze. Obie usługi są pre-GA — potraktuj je jako pilotaż na wycinku katalogu, nie jako wdrożenie na cały katalog, dopóki nie dojrzeją.

A codzienna hydraulika — Ads i Merchant w jednym miejscu

Najbardziej niedoceniana zmiana roku jest mało efektowna: dwie połowy konta e-commerce wreszcie się spotykają.

Co się zmieniło. Od 22 kwietnia 2026 Merchant API jest dostępne z Google Ads Scripts. W połączeniu z product_filters (warunkowe udostępnianie feedu do Google Ads, dostarczone w listopadzie 2025) i CartDataSalesView (v24) pętla między kondycją feedu a wydatkami reklamowymi zamyka się w jednym środowisku.

Dlaczego ma znaczenie dla twojego konta. Stary podział — kampanie w Scripts, feed zarządzany gdzie indziej — oznaczał, że odrzucony produkt dalej przepalał budżet, dopóki ktoś tego nie zauważył. Teraz jeden skrypt może zareagować na odrzucenie feedu, pauzując kampanię albo wyciągając SKU z grupy produktów w PMax. A CartDataSalesView wnosi segmentację konwersji na poziomie produktu do API, więc dostajesz ROAS na poziomie SKU bez ręcznego zszywania danych kampanii z feedem:

-- Product-level ROAS straight from the API (v24+), no manual feed stitching
SELECT segments.product_item_id,
       metrics.conversions_value,
       metrics.cost_micros
FROM cart_data_sales_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.conversions_value DESC

To jedno zapytanie jest wejściem do tieringu rentowności, który kiedyś co miesiąc budowałeś ręcznie. (Zasób to cart_data_sales_view, dostarczony w v24; potwierdź dostępność segmentów w release notes dla swojej wersji.)

Rok na jednej osi czasu

Każda wersja major poniżej pochodzi z oficjalnych release notes; kamienie milowe Merchant z Merchant API latest updates. Prawa kolumna to jedyna, która powinna sterować twoim kalendarzem — wszystko datowane jest nienegocjowalne.

[HARD Aug 18] 1. Feed migration → off v2.1, onto Merchant sub-APIs
[HARD Sep]    2. DSA inventory → run ADOPT_AI_MAX A/B first
[ROLLING]     3. Version watch → alert 60 days pre-sunset
[upside]      4. Asset pipeline → AssetGenerationService / Product Studio
[upside]      5. SKU ROAS → cart_data_sales_view tiering
[upside]      6. Closed loop → Merchant-in-Scripts: disapproval → pause

FAQ