Google Ads API Developer Assistant installieren und verwenden

Vorbereitung

Bevor Sie beginnen, benötigen Sie Folgendes:

  1. Zugriff auf die Google Ads API :

  2. Software :

    • Python 3.10 oder höher. Python ist die Standardsprache. Sie müssen sie also installiert haben und sie muss sich in Ihrem Pfad befinden.
    • Das Google Antigravity-Befehlszeilentool ist installiert.
    • jq (Befehlszeilen-JSON-Prozessor). Das Installationsskript versucht, es zu installieren, falls es fehlt.

  3. Repository :

Jetzt starten

  1. Zum Projektverzeichnis wechseln :

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

    (Hinweis: Wenn Sie die Antigravity-Shell-Integration aktiviert haben, wird die Assistant-Sitzung automatisch initialisiert, wenn Sie dieses Verzeichnis aufrufen).

  2. Installationsskript ausführen:Dieses Skript initialisiert die Entwicklungsumgebung und klont die erforderlichen Google Ads-Clientbibliotheken (Python ist standardmäßig installiert).

    ./install.sh

    Wenn Sie Windows verwenden, führen Sie das PowerShell-Skript install.ps1 aus.

  3. Anmeldedaten konfigurieren:Die Datei google-ads.yaml (oder das entsprechende Sprachäquivalent) muss sich in Ihrem Home-Verzeichnis befinden.

  4. Mit dem Assistant interagieren:Nachdem die Sitzung aktiv ist, können Sie direkt im Terminal in natürlicher Sprache mit dem Assistant interagieren.

Wichtige Features

  • Fragen und Antworten in natürlicher Sprache: Stellen Sie Fragen zu Google Ads API-Funktionen, Best Practices oder bestimmten Ressourcen.

    • „Welche Kampagnentypen sind verfügbar?“
    • „Wie kann ich in GAQL nach Datum filtern?“
    • „Erkläre den Unterschied zwischen click_view und impression_view.“

  • Codegenerierung:Generieren Sie GAQL-Abfragen und ausführbare Python-Code-Snippets.

    • „Zeige mir die Kampagnen mit den meisten Conversions in den letzten 30 Tagen.“
    • „Rufe alle aktivierten Anzeigengruppennamen für die Kampagnen-ID 12345 ab.“
    • „Suche in allen Kampagnen nach abgelehnten Anzeigen.“ Der generierte Code wird automatisch mit ruff geprüft und im Verzeichnis saved/code/ gespeichert.

  • Direkte API-Ausführung:Führen Sie generierte schreibgeschützte Python-Skripts direkt in einer isolierten virtuellen Umgebung (.venv) aus und sehen Sie sich formatierte Ergebnisse als Tabellen in Ihrem Terminal an.

    • Sagen Sie dem Assistant einfach: „Führe den Code aus“ oder „Führe das Skript aus“.
    • Aus Sicherheitsgründen werden mutierende Vorgänge (Erstellen, Aktualisieren, Löschen) generiert, aber niemals ausgeführt.

  • CSV-Export:Speichern Sie tabellarische Ergebnisse aus API-Aufrufen in einer CSV-Datei.

    • „Speichere die Ergebnisse in einer CSV-Datei.“ Dateien werden im Verzeichnis saved/csv/ gespeichert.

  • Erweiterte Diagnose und Fehlerbehebung:Erhalten Sie Hilfe bei Fehlermeldungen, unerwartetem API-Verhalten oder Problemen mit Offline-Conversions.

    • „Warum werden für meine Abfrage keine Ergebnisse angezeigt?“
    • „Behebe Probleme mit meinen Conversions für den Kunden 123-456-7890.“ (Generiert einen detaillierten Diagnosebericht in saved/data/).

  • Zusätzlicher Kontext:Fügen Sie Ihre eigene Codebasis oder benutzerdefinierte Bibliotheken für den Kontext hinzu.

    • Verwenden Sie das Skript update.sh mit der Option --context_path, um Ihre Projektdateien zu registrieren: none ./update.sh --context_path /path/to/your/codebase
    • So kann der Assistant Ihre Anwendungslogik in seine Überlegungen einbeziehen, wenn er Antworten erstellt oder Code in Ihrer bevorzugten Sprache generiert.

Beispielanwendungsfälle

  • Berichterstellung:
    • „Rufe für den Kunden 12345678 die fünf Keywords mit den höchsten Kosten für den letzten Monat ab.“
  • Kontostruktur:
    • „Liste alle Kampagnennamen und ihre IDs auf.“
  • Fehlerbehebung:
    • „Ich habe 100 Conversions hochgeladen, aber nur 78 werden in der Benutzeroberfläche angezeigt. Wie kann ich das mit der API beheben?“
  • Lernen:
    • „/erkläre, was eine gemeinsame Gruppe ist“
  • Codegenerierung:
    • „Schreibe Code, um eine Performance Max-Kampagne für company name zu erstellen.“

Community und Support

Richtlinien für Beiträge

Beiträge sind willkommen. Richtlinien finden Sie in der Datei CONTRIBUTING.md im GitHub-Repository.

Zurück
Was ist der Google Ads API Developer Assistant?