Przedstawiamy asystenta dla deweloperów korzystających z interfejsu Google Ads API w wersji 2.0

Czwartek, 26 lutego 2026 r.

Ta duża aktualizacja przekształca Asystenta z zaawansowanego narzędzia do generowania kodu w aktywnego partnera dla deweloperów Google Ads, który pomaga w rozwiązywaniu problemów i automatyzacji. Od czasu wydania wersji 1.6.0 wysłuchaliśmy Waszych opinii i skupiliśmy się na najtrudniejszych aspektach tworzenia interfejsów API: diagnostyce, spójności i konfiguracji.

Co nowego w wersji 2.0?

1. Prostsza instalacja i konserwacja

Konfigurowanie środowiska programistycznego obsługującego wiele języków nie musi być trudne.

  • Konfiguracja za pomocą jednego polecenia: użyj nowej flagi --install-deps z install.sh lub install.ps1, aby jednocześnie obsłużyć zależności pip, composer i bundler.
  • Ujednolicona struktura katalogów: cały wygenerowany kod, wyeksportowane pliki CSV i raporty diagnostyczne są teraz uporządkowane w jednym katalogu saved/ z podkatalogami dla każdego typu danych wyjściowych.
  • Aktualizacja za pomocą jednego polecenia: gdy zostanie wydana nowa wersja interfejsu API i bibliotek klienta, musisz wykonać polecenie update.sh, aby korzystać z najnowszej wersji. Możesz też użyć update.sh, aby dodać do kontekstu dodatkowe biblioteki klienta.

2. Rozwiązywanie problemów z konwersjami agentowymi

Śledzenie konwersji offline to jedna z najbardziej zaawansowanych, a zarazem złożonych funkcji interfejsu Google Ads API. Ustalanie, dlaczego konwersja nie została przypisana, może być czasochłonnym procesem ręcznym.

W wersji 2.0 wprowadziliśmy specjalny pakiet narzędzi do rozwiązywania problemów z konwersjami i ich diagnostyki.

  • Nowy skrypt: api_examples/collect_conversions_troubleshooting_data.py
  • Nowe polecenie: /conversions_support_data

Skrypt generuje standardowe raporty na potrzeby rozwiązywania problemów z konwersjami i zapewnia Asystentowi kontekst, który pomaga mu rozwiązywać problemy.

Polecenie jest najbardziej przydatne, gdy Asystent przeanalizuje problem z konwersją i spróbuje go rozwiązać. Jeśli nie, a Ty musisz skontaktować się z zespołem pomocy, to polecenie przeanalizuje ustawienia klienta, działania powodujące konwersję i podsumowania przesyłania, aby wygenerować uporządkowany raport diagnostyczny na podstawie przeprowadzonej już analizy. Automatycznie identyfikuje nawet „nieprawidłowe” stany i wysokie współczynniki błędów, co pozwala zaoszczędzić wiele godzin na analizowaniu logów. Zapisuje wyniki w pliku tekstowym, który możesz dołączyć do zgłoszenia do zespołu pomocy, jeśli zajdzie taka potrzeba.

3. Zbudowana na potrzeby najnowszego interfejsu API (wersja 23)

Wersja 2.0 w pełni obsługuje interfejs Google Ads API w wersji 23. Zaktualizowaliśmy wszystkie interaktywne przykłady, a wewnętrzny kontekst asystenta jest teraz zoptymalizowany pod kątem najnowszych zasobów i pól, dzięki czemu generowany kod jest gotowy do wykorzystania w środowisku produkcyjnym.

4. Płynna automatyzacja dzięki punktom zaczepienia sesji

Dodaliśmy punkty zaczepienia SessionStart i SessionEnd, aby usprawnić przepływ pracy.

  • Konfiguracja automatyczna: asystent może teraz automatycznie lokalizować plik konfiguracji w katalogu $HOME na początku sesji. Kopiuje go do podkatalogu config w katalogu projektu. Python jest preferowanym językiem Gemini do wysyłania zapytań do interfejsu API. Jeśli więc używasz innego języka, odczytuje on plik konfiguracji i tworzy tymczasowy plik google-ads.yaml w konfiguracji na potrzeby zapytań, ale nadal odpowiada w kodzie preferowanego języka.
  • Automatyczne czyszczenie: tymczasowe konfiguracje są bezpiecznie usuwane po wyjściu, dzięki czemu obszar roboczy pozostaje czysty, a Twoje dane logowania są bezpieczne.

5. Ulepszona weryfikacja GAQL

Tworzenie złożonych zapytań GAQL jest teraz łatwiejsze niż kiedykolwiek. Zaktualizowaliśmy GEMINI.md i conversions/GEMINI.md, wprowadzając rygorystyczne reguły sprawdzania poprawności w przypadku najnowszych skrajnych przypadków interfejsu API, w tym ulepszoną obsługę segmentów dat i wymagań dotyczących zakresu skończonego. Asystent wykrywa teraz błędy w logice przed wykonaniem zapytania.

6. Umiejętności

Umiejętność to miniwtyczka lub „schemat zachowania”. Ogólny kontekst (np. plik GEMINI.md) dostarcza informacji o tle, ale umiejętność jest „ładowana” do mózgu AI tylko wtedy, gdy musi ona wykonać złożone, proceduralne zadanie, takie jak uzyskanie bieżącej wersji tego rozszerzenia. Nie wykonujesz umiejętności bezpośrednio. Gemini decyduje, kiedy go potrzebuje.

Chociaż jest to nadal funkcja eksperymentalna, dodaliśmy ją w tej wersji, aby uzupełnić nasze wykorzystanie punktów zaczepienia do inicjowania i czyszczenia sesji.

Dlaczego warto przejść na wyższy pakiet dodatkowego miejsca?

Przejście z wersji 1.6.0 na 2.0.0 to nie tylko nowe funkcje, ale też niezawodność. Dzięki połączeniu dogłębnej wiedzy o interfejsie API z automatycznymi narzędziami diagnostycznymi wersja 2.0 skraca proces „prób i błędów”, który często spowalnia integrację interfejsu API.

Niezależnie od tego, czy debugujesz przesyłanie konwersji, czy tworzysz złożone potoki raportowania, wersja 2.0 zapewnia narzędzia, które pozwalają pracować szybciej i z większą pewnością.

Pierwsze kroki

Pierwsza instalacja

Uaktualnianie z poprzedniej wersji

  • Skopiuj cały niestandardowy kod z plików saved_code/ i saved_csv/ do bezpiecznej lokalizacji.
  • Usuń lokalny klon asystenta dewelopera interfejsu Google Ads API, usuwając katalog projektu oraz wszystkie podkatalogi i pliki.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • W katalogu projektu uruchom install.sh lub install.ps1, aby zainstalować rozszerzenie i biblioteki klienta.

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

Etykiety: google-ads-api, release