Przedstawiamy asystenta programisty interfejsu Google Ads API w wersji 3.0.0

Środa, 10 czerwca 2026 r.

Z przyjemnością informujemy o wydaniu wersji 3.0.0 rozszerzenia interfejsu Google Ads API Developer Assistant. Ta wersja to ważny krok w rozwoju Asystenta, który koncentruje się na modernizacji architektury, zwiększeniu niezawodności i bardziej modułowej konstrukcji.

W tej wersji przenosimy Asystenta na platformę agentów Google Antigravity i przechodzimy na architekturę opartą na umiejętnościach. Dzięki tym zmianom asystent jest bardziej niezawodny, łatwiejszy w utrzymaniu i zużywa mniej tokenów.

Nowości w wersji 3.0.0

1. Oparte na platformie Antigravity

Asystent dewelopera interfejsu Google Ads API został przeniesiony z gemini-cli do platformy agenta Antigravity (wersja 3.0.0). To uaktualnienie podstawowej platformy zapewnia bardziej ustrukturyzowane i niezawodne środowisko wykonawcze. Oprócz tego zaktualizowaliśmy strukturę katalogów i plików projektu, aby była w pełni zgodna z Antigravity.

Obsługa gemini-cli zakończy się 18 czerwca 2026 r., jak opisano w tym ogłoszeniu na blogu Google.

2. Modułowa architektura oparta na umiejętnościach

Przekształciliśmy podstawowe funkcje Asystenta w umiejętności. Zamiast polegać na ogólnych, nieustrukturyzowanych instrukcjach w pliku kontekstowym, Asystent wczytuje teraz dynamicznie specjalistyczne, przetestowane katalogi narzędzi (umiejętności), gdy są potrzebne. Znacznie ogranicza to „halucynacje” i zapewnia, że zadania są wykonywane przy użyciu precyzyjnych, zweryfikowanych procedur.

Najważniejsze zmiany w ramach tego modułowego przejścia:

  • Weryfikacja GAQL (validate_gaql): przeniesiono do osobnej umiejętności. Teraz obejmuje ono ulepszone statyczne sprawdzanie zapytań pod kątem segmentów dat, filtrów jednodniowych click_view i granic change_status.
  • Rozwiązywanie problemów z konwersjami (troubleshoot_conversions): zastępuje stare narzędzie conversions_support_package. Konsoliduje wszystkie skrypty rozwiązywania problemów z konwersjami i podsumowania przesyłania oraz testy w jednym, spójnym katalogu umiejętności.
  • Polecenia strukturalne (explain i step_by_step): przekonwertowane na umiejętności, aby wymusić spójne, ustrukturyzowane układy wyjaśnień.
  • Nowe mapowanie kont (get_cids_under_mcc): nowa umiejętność umożliwiająca pobieranie wszystkich kont podrzędnych na koncie menedżera (MCK).
  • Nowa kontrola obiektów (inspect_object): nowa umiejętność dynamicznego wyszukiwania wiadomości Protobuf i typów wyliczeniowych na bieżąco, która pomaga zapewnić, że Asystent zawsze używa prawidłowych struktur.
  • Nowy filtr informacji o produktach w kampaniach Performance Max (pmax_listing_filter): nowa umiejętność, która umożliwia standaryzację modyfikacji drzewa wykluczeń stron internetowych w grupach informacji o produktach w kampaniach Performance Max.

3. Większa spójność i rygorystyczność

Wprowadziliśmy bardziej rygorystyczne zasady i wymagania, aby zapewnić wysoką jakość generowania kodu i walidacji zapytań:

  • Jawne wersjonowanie interfejsu API: kluczowe umiejętności, takie jak get_cids_under_mcc, validate_gaql i troubleshoot_conversions, wymagają teraz jawnego argumentu api_version, co eliminuje niejednoznaczność.
  • Rygorystyczne reguły GAQL:
    • Dodano regułę do AGENTS.md, aby zapobiec używaniu funkcji agregujących SQL (takich jak SUM, COUNT i AVG) w zapytaniach GAQL, ponieważ nie są one obsługiwane.
    • Dodaliśmy regułę, która najpierw sprawdza informacje o wersji na stronie dla deweloperów interfejsu Google Ads API, aby upewnić się, że asystent korzysta z aktualnej dokumentacji.
    • Uproszczona konfiguracja: uprościliśmy AGENTS.md, co pozwoliło zmniejszyć początkowe okno kontekstu. Usunęliśmy dokumentację dotyczącą duplikatów konwersji, aby skupić się na umiejętnościach programistycznych.

4. Ulepszenia środowiska programistycznego (DX)

Wprowadziliśmy kilka ulepszeń, które przyspieszają i ułatwiają proces programowania:

  • Trwałe środowisko wirtualne (.venv): środowisko wirtualne nie jest już usuwane na koniec sesji. Podczas uruchamiania asystent sprawdza wersję Pythona w systemie. Przebudowuje .venv tylko wtedy, gdy dostępna jest nowsza wersja Pythona.
  • Inteligentne buforowanie wersji interfejsu API: asystent buforuje teraz bieżącą wersję interfejsu Google Ads API z czasem TTL wynoszącym 19 godzin, co skraca czas uruchamiania dzięki unikaniu zbędnych kontroli sieci.
  • Lepsze debugowanie dzięki trwałym logom: komunikaty logu zawierają teraz sygnatury czasowe. Plik dziennika jest zapisywany w katalogu .agents/ i nie jest już resetowany przy każdym uruchomieniu, co pozwala zachować historię na potrzeby rozwiązywania problemów.

Dlaczego warto przejść na wyższą wersję?

Uaktualnienie do wersji 3.0.0 dotyczy głównie niezawodności i struktury. Dzięki przejściu na platformę Antigravity i podziałowi funkcji na moduły umiejętności Asystent stał się bardziej przewidywalny i efektywniej wykorzystuje zasoby.

Jeśli chcesz, aby uruchamianie było szybsze, weryfikacja GAQL bardziej niezawodna, a rozwiązywanie problemów skuteczniejsze, zalecamy przejście na wersję 3.0.0.

Rozpocznij

Pierwsza instalacja

  1. Zainstaluj Antigravity CLI: postępuj zgodnie z instrukcjami na stronie https://antigravity.google/.
  2. Sklonuj asystenta: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. Uruchom skrypt instalacyjny:
    • Linux/macOS: uruchom ./install.sh (domyślnie obsługuje Pythona, użyj flag takich jak --php lub --ruby w przypadku innych języków).
    • Windows: otwórz PowerShell i uruchom .\install.ps1.

Uaktualnianie z wersji 2.x

  1. Skopiuj niestandardowy kod lub dane z saved/ do bezpiecznej lokalizacji poza katalogiem projektu.
  2. Usuń lokalny klon Asystenta.
  3. Sklonuj repozytorium:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. Uruchom skrypt instalacyjny (install.sh lub install.ps1), aby zainicjować nowe środowisko Antigravity.

Bob Hancock, zespół ds. interfejsu Google Ads API

Etykiety: google-ads-api, release