Instalowanie i używanie Asystenta programisty interfejsu Google Ads API

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.
    • Zainstalowano gemini-cli.
    • jq (procesor JSON wiersza poleceń). Skrypt instalacyjny spróbuje zainstalować ten pakiet, jeśli go nie ma.

  3. Repozytorium:

Rozpocznij

  1. Przejdź do katalogu projektu:

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

  2. Uruchom skrypt konfiguracyjny: ten skrypt konfiguruje gemini-cli tak, aby korzystał z plików kontekstu i niezbędnych narzędzi asystenta.GEMINI.md

    ./install.sh

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

  3. Uruchom gemini-cli:

    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 gemini-cli 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, jeśli Twoim domyślnym językiem jest Python, Ruby lub PHP. Skompilowane języki nie będą działać z powodu zasad bezpieczeństwa.

  • 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:
    • „/wyjaśnij, czym jest zestaw udostępniony”
  • Generowanie kodu:
    • „Napisz kod, aby utworzyć kampanię Performance Max na koncie company name”.

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.