Asystent dewelopera interfejsu Google Ads API

Asystent programisty interfejsu Google Ads API to zaawansowane rozszerzenie interfejsu Gemini CLI, które przyspiesza przepływy pracy związane z interfejsem Google Ads API. Asystent umożliwia interakcję z interfejsem Google Ads API za pomocą języka naturalnego, co ułatwia zadawanie pytań, generowanie kodu, pobieranie danych i rozwiązywanie problemów bezpośrednio w terminalu.

Zalety

  • Zwiększ produktywność: poświęcaj mniej czasu na przeszukiwanie dokumentacji i pisanie kodu standardowego.
  • Uprość złożone zadania: generuj kod języka zapytań Google Ads (GAQL) i biblioteki klienta na podstawie prostych promptów w języku angielskim.
  • Poznaj interfejs API: dowiedz się, jak działają interfejsy API, i zobacz, jak żądania w języku naturalnym przekładają się na wykonywalny kod.
  • Interaktywne debugowanie: uzyskaj pomoc w zrozumieniu błędów i szczegółowe instrukcje rozwiązywania problemów.
  • Uproszczony proces: możesz rozwijać i testować aplikację w wierszu poleceń.

Wymagania wstępne

Zanim zaczniesz, upewnij się, że:

  1. Dostęp do interfejsu Google Ads API:

  2. Oprogramowanie:

    • Python w wersji 3.10 lub nowszej. Python jest językiem domyślnym, więc musisz mieć go zainstalowanego i dostępnego w ścieżce.
    • Zainstalowany interfejs wiersza poleceń Gemini.
    • jq (procesor JSON wiersza poleceń). Skrypt instalacyjny spróbuje zainstalować ten pakiet, jeśli go nie ma.

  3. Repozytorium:

    • Lokalna kopia repozytorium google-ads-api-developer-assistant z GitHub:

Rozpocznij

  1. Przejdź do katalogu projektu:

    cd <full path>/google-ads-api-developer-assistant

  2. Uruchom skrypt konfiguracji: ten skrypt konfiguruje interfejs Gemini CLI tak, aby korzystał z plików kontekstowych asystentaGEMINI.md i niezbędnych narzędzi.

    ./setup.sh

    Jeśli korzystasz z systemu Windows, uruchom setup.ps1skrypt PowerShell.

  3. Uruchom interfejs wiersza poleceń Gemini:

    gemini

  4. Interakcja z Asystentem: możesz teraz zadawać pytania i wydawać polecenia w języku naturalnym.

Najważniejsze funkcje

  • Pytania i odpowiedzi w języku naturalnym: zadawaj pytania o funkcje interfejsu Google Ads API, sprawdzone metody lub konkretne zasoby.

    • „Wskaż dostępne typy kampanii”.
    • „Jak filtrować według daty w GAQL?”
    • „Wyjaśnij różnicę między click_view a impression_view”.

  • Generowanie kodu: generowanie zapytań GAQL i wykonywalnych fragmentów kodu w Pythonie.

    • „Pokaż mi kampanie z największą liczbą konwersji w ciągu ostatnich 30 dni”.
    • „Pobierz wszystkie nazwy włączonych grup reklam w kampanii o identyfikatorze 12345”.
    • „Znajdź odrzucone reklamy we wszystkich kampaniach”. Wygenerowany kod jest zapisywany w katalogu saved_code/.

  • Bezpośrednie wykonywanie interfejsu API: uruchamiaj wygenerowane skrypty Pythona tylko do odczytu bezpośrednio z interfejsu wiersza poleceń Gemini i wyświetlaj sformatowane wyniki w terminalu. Po wygenerowaniu kodu przez asystenta na ekranie pojawi się prośba:

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

Wpisz run, a skrypt zostanie wykonany w kontekście Asystenta.

  • Eksportowanie do pliku CSV: zapisywanie wyników w formie tabeli z wywołań interfejsu API w pliku CSV.

    • „Zapisz wyniki w pliku CSV”. Pliki są zapisywane w katalogu saved_csv/.

  • Pomoc w rozwiązywaniu problemów: uzyskaj pomoc dotyczącą komunikatów o błędach lub nieoczekiwanego działania interfejsu API.

    • „Pojawia się błąd 'AuthenticationError.OAUTH_TOKEN_INVALID'. Co mam zrobić?”
    • „Dlaczego nie widzę żadnych wyników dla mojego zapytania?”

Przykłady użycia

  • Raportowanie:
    • „Podaj 5 najpopularniejszych słów kluczowych według kosztu z zeszłego miesiąca dla klienta 12345678”.
  • Struktura konta:
    • „Wyświetl wszystkie nazwy kampanii i ich identyfikatory”.
  • Rozwiązywanie problemów:
    • „Przesłano 100 konwersji, ale w interfejsie użytkownika widać tylko 78. Jak mogę to debugować za pomocą interfejsu API?”
  • Nauka:
    • „Pokaż mi, jak utworzyć kampanię Performance Max za pomocą interfejsu API”.

Społeczność i pomoc

Wskazówki dotyczące udostępniania

Udostępniane przez Was informacje są mile widziane. Wskazówki znajdziesz w pliku CONTRIBUTING.md w repozytorium GitHub.