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:

  3. Repozytorium:

Rozpocznij

  1. Przejdź do katalogu projektu:

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

    (Uwaga: jeśli masz włączoną integrację powłoki Antigravity, wejście do tego katalogu automatycznie zainicjuje sesję asystenta).

  2. Uruchom skrypt instalacyjny: ten skrypt inicjuje środowisko programistyczne i klonuje wymagane biblioteki klienta Google Ads (Python jest instalowany domyślnie).

    ./install.sh

    Jeśli korzystasz z systemu Windows, uruchom skrypt PowerShell install.ps1.

  3. Skonfiguruj dane logowania: upewnij się, że plik google-ads.yaml (lub jego odpowiednik w danym języku) znajduje się w katalogu domowym.

  4. Korzystaj z Asystenta: po aktywowaniu sesji możesz korzystać z Asystenta, używając języka naturalnego bezpośrednio w terminalu.

Najważniejsze funkcje

  • Pytania i odpowiedzi w języku naturalnym: zadawaj pytania dotyczące funkcji interfejsu Google Ads API, sprawdzonych metod lub konkretnych zasobów.

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

  • Generowanie kodu: generuj zapytania GAQL i wykonywalne fragmenty kodu w Pythonie.

    • „Pokaż kampanie z największą liczbą konwersji w ciągu ostatnich 30 dni”
    • „Pobierz wszystkie włączone nazwy grup reklam dla kampanii o identyfikatorze kampanii 12345”
    • „Znajdź odrzucone reklamy we wszystkich kampaniach” Wygenerowany kod jest automatycznie sprawdzany za pomocą narzędzia ruff i zapisywany w katalogu saved/code/.

  • Bezpośrednie wykonywanie interfejsu API: uruchamiaj wygenerowane skrypty w Pythonie tylko do odczytu bezpośrednio w odizolowanym środowisku wirtualnym (.venv) i wyświetlaj sformatowane wyniki w postaci tabel w terminalu.

    • Po prostu powiedz Asystentowi: „Uruchom kod” lub „Wykonaj skrypt”.
    • Ze względów bezpieczeństwa operacje modyfikujące (tworzenie, aktualizowanie, usuwanie) są generowane, ale nigdy nie są wykonywane.

  • Eksport do pliku CSV: zapisuj wyniki tabelaryczne z wywołań interfejsu API w pliku CSV.

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

  • Zaawansowana diagnostyka i rozwiązywanie problemów: uzyskaj pomoc w przypadku komunikatów o błędach, nieoczekiwanego działania interfejsu API lub problemów z konwersjami offline.

    • „Dlaczego nie widzę żadnych wyników zapytania?”
    • „Rozwiąż problemy z konwersjami klienta 123-456-7890” (Generuje szczegółowy raport diagnostyczny w katalogu saved/data/).

  • Dodatkowy kontekst: dodaj własną bazę kodu lub biblioteki niestandardowe, aby uzyskać kontekst.

    • Aby zarejestrować pliki projektu, użyj skryptu update.sh z opcją --context_path: none ./update.sh --context_path /path/to/your/codebase
    • Dzięki temu Asystent może uwzględniać logikę aplikacji podczas tworzenia odpowiedzi lub generowania kodu w preferowanym języku.

Przykłady użycia

  • Raportowanie:
    • „Pobierz 5 najpopularniejszych słów kluczowych według kosztu z ostatniego miesiąca dla klienta 12345678”
  • Struktura konta:
    • „Wyświetl wszystkie nazwy kampanii i ich identyfikatory”
  • Rozwiązywanie problemów:
    • „Przesłałem 100 konwersji, ale w interfejsie użytkownika widzę tylko 78. Jak mogę to sprawdzić za pomocą interfejsu API?”
  • Nauka:
    • „/wyjaśnij, czym jest zestaw wspólny”
  • Generowanie kodu:
    • „Napisz kod, aby utworzyć kampanię Performance Max dla company name”

Społeczność i pomoc

Wytyczne dotyczące udziału

Zachęcamy do udziału! Wytyczne znajdziesz w pliku CONTRIBUTING.md w repozytorium GitHub.

Wstecz
Czym jest Asystent programisty interfejsu Google Ads API?