Google Ads API Developer Assistant installieren und verwenden

Vorbereitung

Bevor Sie beginnen, benötigen Sie Folgendes:

  1. Google Ads API-Zugriff:

  2. Software:

    • Python 3.10 oder höher. Python ist die Standardsprache. Sie muss also installiert sein und sich in Ihrem Pfad befinden.
    • Das Google Antigravity-Befehlszeilentool ist installiert.
    • jq (Befehlszeilen-JSON-Prozessor). Das Installationsskript versucht, diese zu installieren, falls sie 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:Mit diesem Skript wird die Entwicklungsumgebung initialisiert und die erforderlichen Google Ads-Clientbibliotheken geklont (Python ist standardmäßig installiert).

    ./install.sh

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

  3. Anmeldedaten konfigurieren:Achten Sie darauf, dass sich Ihre google-ads.yaml (oder das entsprechende Sprachäquivalent) in Ihrem Home-Verzeichnis befindet.

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

Wichtige Features

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

    • Welche Kampagnentypen gibt es?
    • „Wie filtere ich in GAQL nach Datum?“
    • Erkläre den Unterschied zwischen „click_view“ und „impression_view“.

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

    • „Zeig mir die Kampagnen mit den meisten Conversions in den letzten 30 Tagen.“
    • „Get all enabled ad group names for campaign ID 12345.“ (Rufe alle aktivierten Anzeigengruppennamen für die Kampagnen-ID 12345 ab.)
    • „Abgelehnte Anzeigen in allen Kampagnen finden“ Der generierte Code wird automatisch mit ruff gelintet und im Verzeichnis saved/code/ gespeichert.

  • Direkte API-Ausführung:Generierte schreibgeschützte Python-Skripts direkt in einer isolierten virtuellen Umgebung (.venv) ausführen und formatierte Ergebnisse als Tabellen im Terminal ansehen.

    • Sagen Sie einfach zu Assistant: „Führe den Code aus“ oder „Führe das Script aus“.
    • Aus Sicherheitsgründen werden Mutationen (Erstellen, Aktualisieren, Löschen) zwar generiert, aber nie ausgeführt.

  • CSV-Export:Tabellarische Ergebnisse aus API-Aufrufen in einer CSV-Datei speichern.

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

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

    • „Warum sehe ich keine Ergebnisse für meine Anfrage?“
    • „Troubleshoot my conversions for customer 123-456-7890.“ (Generiert einen detaillierten Diagnosebericht in saved/data/).

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

    • Verwenden Sie das update.sh-Skript 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

  • Berichte:
    • „Gib mir die fünf wichtigsten Keywords nach Kosten für den letzten Monat für Kunde 12345678.“
  • Kontostruktur:
    • „Liste alle Kampagnennamen und ihre IDs auf.“
  • Fehlerbehebung:
    • „Ich habe 100 Conversions hochgeladen, aber nur 78 werden auf der Benutzeroberfläche angezeigt. Wie kann ich das mit der API beheben?“
  • Lernen:
    • „/explain what a shared set is“ (Erkläre, was ein gemeinsames Set 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?