Rok z Google Ads API: dwa twarde terminy, reszta to okazja

W styczniu Google wydał v23 Ads API i ogłosił, że od tej pory nowa wersja będzie wychodzić co miesiąc. Przeczytałem to dwa razy. Od dwunastu lat piszę kod, który wywołuje to API, i przez większość tego czasu zmieniało się ono na tyle wolno, że zaglądałeś do niego raz w roku, podbijałeś numer wersji i znowu o nim zapominałeś.

Potem zrobiłem to, czego nauczyły mnie te lata. Otworzyłem nasz kod w Lyncie i wyszukałem shoppingcontent.googleapis.com. Każde trafienie to skrypt, który umiera 18 sierpnia 2026, w dniu wyłączenia Content API for Shopping. Za tą datą czai się druga, którą Google zdążył już przesunąć. Od lutego 2027 każda pozostała kampania Dynamic Search Ads (DSA) automatycznie przechodzi na AI Max, czy tego chcesz, czy nie. We wrześniu 2026 jako pierwsze przechodzą kampanie korzystające z automatycznie tworzonych komponentów i dopasowania przybliżonego na poziomie kampanii.

Te dwie daty to obowiązkowa część tego roku z Google Ads API. Cała reszta, którą wydała platforma, to okazja: usługi AI dla kreacji, raportowanie sprzedaży na poziomie produktu, Merchant API wewnątrz Google Ads Scripts. Przejdę więc przez rok według priorytetów, najtwardszy termin najpierw. Przy każdej zmianie: co to jest, dlaczego dotyczy twojego konta i jakie dokładnie wywołanie, payload albo migrację uruchomić.

Niczego nie zostawię na etapie „powinieneś zmigrować”. Termin bez konkretnego artefaktu to tylko niepokój. Na każdym kroku dostajesz endpoint zastępujący stary, payload eksperymentu albo zapytanie GAQL, więc dokładnie widzisz, co zbudować, zanim data nadejdzie.

Termin numer jeden: Content API for Shopping umiera 18 sierpnia 2026

To najtwardsza data roku, więc idzie pierwsza.

Co się zmieniło. Content API for Shopping v2.1 gaśnie 18 sierpnia 2026. Jego następca, Merchant API v1, jest w GA od lipca 2025, a pośrednia v1beta już zgasła 28 lutego 2026. Stary monolit zastępują wyspecjalizowane pod-API. datasources, products, inventories, reports, notifications.

Dlaczego dotyczy twojego konta. Wszystko, co dotyka twojego feedu przez stare API, przestaje tego dnia działać. Przesyłanie feedów, feedy uzupełniające, etykiety niestandardowe, aktualizacje cen i stanów, odczyt odrzuceń. To nie jest „fajnie byłoby zmigrować”, to twarde cięcie. Jeśli dzienny skrypt synchronizuje ci ceny, 18 sierpnia zamilknie, a feed powoli rozjedzie się z rzeczywistością, aż ktoś zauważy utracony przychód. Widziałem ten scenariusz na prawdziwych kontach i kosztowna nigdy nie jest sama awaria, kosztowne są tygodnie, w których nikt jej nie zauważa.

Co zrobić. Przebuduj swoją integrację pod nową strukturę pod-API. Migracja jest mechaniczna. Zmienia się host, ścieżka i model zasobów, intencja zostaje. Oto stan przed i po dla najczęstszego wywołania ze wszystkich, 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ów i podział na pod-API pochodzą z dokumentacji Google. Dokładne body żądania dla swojego zasobu sprawdź przed wdrożeniem w referencji Merchant API, bo zmieniły się nazwy pól, nie tylko URL.)

Merchant API v1 to lepsze API niż Content API, które zastępuje, i właśnie tego nikt ci nie mówi. Trzy ulepszenia, które dziedziczysz za darmo dzięki migracji:

Jeśli od dawna zbierałeś się do utwardzenia narzędzi feedowych, wyłączenie jest tym, co wreszcie cię do tego zmusi. Przebuduj raz, a wyjdziesz z czystszą obsługą błędów i mniejszą liczbą wywołań tam i z powrotem, niż v2.1 kiedykolwiek pozwalała.

Termin numer dwa: Dynamic Search Ads stają się AI Max w lutym 2027

To druga zmiana z konkretną datą. Wpływa na zakres twojej kontroli nad kampanią.

Co się zmieniło. AI Max for Search osiągnął GA 15 kwietnia 2026 po starcie bety w maju 2025. Wdrożenie odbywa się w dwóch etapach: od września 2026 Google automatycznie przenosi na AI Max kampanie korzystające z automatycznie tworzonych komponentów i dopasowania przybliżonego na poziomie kampanii, a wyłączenie i automatyczna migracja samych DSA zaczynają się w lutym 2027, po przesunięciu pierwotnie zapowiedzianego terminu wrześniowego. Potem nowej kampanii DSA już nie utworzysz. Ani w interfejsie, ani w Editorze, ani przez API.

Dlaczego dotyczy twojego konta. Wymieniasz kontrolę na wzrost. Z pełnym zestawem funkcji (dopasowanie haseł plus personalizacja tekstu plus ekspansja finalnych URL-i) Google raportuje około +7% konwersji lub wartości konwersji względem samego dopasowania haseł. W zamian oddajesz modelowi dopasowanie, teksty komponentów i wybór strony docelowej. Jeśli ręcznie zaszyłeś w konfiguracji DSA zasady dotyczące marki lub zgodności, automatyczne przejście na AI Max może zacząć kierować ruch na URL-e, których nigdy nie zatwierdziłeś, i wyświetlać teksty reklamowe bez twojej akceptacji. Automatyzacja, której nie zmierzyłeś, to automatyzacja, której nie kontrolujesz.

Co zrobić. Nie czekaj, aż się okaże, co zmiana zrobi z twoimi liczbami. Zmierz to teraz. Google wydał w API zabezpieczenia i punkty pomiarowe równolegle z funkcją, więc możesz przełączenie przetestować A/B na własnych danych, zanim stanie się obowiązkowe:

Praktycznym rozwiązaniem jest eksperyment ADOPT_AI_MAX. Utwórz go na swoich kontach i pozwól mu działać. Deltę CPA i ROAS odczytasz, porównując kampanie z grupy eksperymentalnej z kampaniami kontrolnymi. Zwykłe zapytanie GAQL pokaże ci potem, co ekspansja bez słów kluczowych naprawdę dopasowała i zarobiła:

-- 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 to jeden z nowych typów eksperymentów z v24.1; targeting_expansion_view to zasób raportowy z v22. Dostępność pól sprawdź w release notes wersji, którą wywołujesz.)

Termin kroczący: wydanie co miesiąc

Nie pojedyncza data, tylko zegar, który tyka już bez przerwy.

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

Dlaczego dotyczy twojego konta. Szybszy dostęp do funkcji i szybsze starzenie się. Wersje wygasają według opublikowanego kalendarza. v20 dobiega końca życia w czerwcu 2026, v21 w sierpniu, v22 w październiku. Miesięczny bump minor niczego nie psuje. Przegapiony sunset wersji major oznacza, że skrypty zaczynają zwracać błędy bez innego ostrzeżenia niż data w kalendarzu, którego nie obserwowałeś.

Co zrobić. Przypnij swoją wersję i pilnuj kalendarza sunsetów. Najtańszym ubezpieczeniem jest cykliczna kontrola, która wie, jaką wersję wywołujesz, i odzywa się około 60 dni przed wygaśnięciem. Całość 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"}  # 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 wygaszonej wersji to awaria, którą zafundowałeś sobie sam. Traktuj zarządzanie wersjami jak stałe cykliczne zadanie, a nie jak coś, co załatwia się na ostatnią chwilę.

A teraz bonus: AI wprowadza się do kreacji i feedu

Po uporaniu się z terminami sam wyznaczasz tempo reszty roku. Dwie usługi zamieniły pracę nad komponentami i feedem w coś, co oskryptujesz na tysiącach SKU.

• AssetGenerationService (Ads API, v22, zamknięta beta). Generowanie tekstów i obrazów przez AI, z ulepszaniem i ekstrakcją obrazów dla PMax; v23.2 dodała VideoEnhancement dla wideo generowanego przez Google. Tworzenie kreacji wychodzi z interfejsu do programowalnej warstwy.
• Product Studio (Merchant API, alpha od kwietnia 2025). Generowane przez AI tytuły i opisy produktów plus AutomatedDiscounts do cen w czasie rzeczywistym. Przepisywanie tytułów na poziomie API oznacza masowe ulepszanie tysięcy SKU bez pracy ręcznej.

Feedowa połowa to dla mnie sprawa osobista. W Lyncie przez dwa lata budowaliśmy Boostorę, warstwę AI wzbogacającą feedy Merchant Center, bo jakość feedu wyznacza górną granicę wyników Shopping i PMax. Lepsze tytuły przynoszą większy wzrost przychodu niż większość zmian stawek. Product Studio wnosi kawałek tej zdolności prosto do platformy.

Pipeline, który to odblokowuje, czyta SKU z feedu, generuje zgodny tytuł, opis i komponenty graficzne i wypycha je prosto do grupy zasobów, bez ręcznego przystanku w Canvie po drodze. Obie usługi są pre-GA. Traktuj je jak pilotaż na wycinku katalogu, nie jak rollout na cały katalog, dopóki nie wejdą w GA.

Integracja: Ads i Merchant wreszcie razem

Najbardziej niedoceniana zmiana roku jest zupełnie nieefektowna. Dwie połowy konta e-commerce lądują w jednym miejscu.

Co się zmieniło. Od 22 kwietnia 2026 Merchant API jest osiągalne z Google Ads Scripts. Połącz to z product_filters (warunkowe udostępnianie feedu Google Ads, wydane w listopadzie 2025) i CartDataSalesView (v24), a pętla od stanu feedu do wydatków reklamowych domknie się w jednym środowisku.

Dlaczego dotyczy twojego konta. Stary podział trzymał kampanie w Scripts, a feed gdzie indziej. Odrzucony produkt palił budżet dalej, dopóki człowiek tego nie zauważył. Teraz jeden skrypt może zareagować na odrzucenie w feedzie pauzą kampanii albo wyjęciem SKU z grupy produktów w PMax. A CartDataSalesView wnosi do API przychód per sprzedane SKU z danych koszyka. Niesie przychód, nie wydatki, więc prawdziwy ROAS per SKU wymaga dwóch zapytań. Zacznij od strony przychodowej:

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

Potem pobierz stronę kosztową ze shopping_performance_view i połącz oba wyniki po 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

Na podstawie tych połączonych wierszy wyznaczysz poziomy rentowności, które wcześniej co miesiąc opracowywałeś ręcznie. Dla klientów prowadzimy raportowanie biznesowe na poziomie klienta w BigQuery i połową pracy zawsze było zszywanie danych reklamowych z produktowymi. Zszywanie, które kiedyś wymagało eksportu feedu, robią teraz dwa wywołania API, a wynik sprawdzisz sam. Sprawdź, czy item ID zgadzają się w obu zapytaniach, zanim zaufasz wskaźnikowi. (Zasób to cart_data_sales_view z v24; dostępność segmentów sprawdź w release notes swojej wersji.)

Rok na jednej osi czasu

Każda wersja major poniżej pochodzi z oficjalnych release notes; kamienie milowe Merchanta z Merchant API latest updates. Prawa kolumna jest jedyną, która powinna sterować twoim kalendarzem. Każdy wiersz z flagą HARD oznacza obowiązek, którego nie można pominąć.

Pierwsza godzina pracy

Nie cała migracja. Grep. Przeszukaj swój kod pod kątem shoppingcontent.googleapis.com i zapisz każde zadanie, które wyskoczy. Ta lista to wszystko, co jest u ciebie zagrożone 18 sierpnia, a zajęła ci dziesięć minut.

Resztę godziny poświęć na utworzenie jednego eksperymentu ADOPT_AI_MAX na koncie, gdzie DSA znaczy najwięcej, żeby migracja była zmierzoną zmianą, a nie niespodzianką. Terminy należą do Google. To, czy uderzą w ciebie jako awarie, czy jako ulepszenia, wciąż zależy od ciebie.

FAQ