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.
    • gemini-cli 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

  2. Setup-Script ausführen:Dieses Script konfiguriert gemini-cli so, dass die GEMINI.md-Kontextdateien und erforderlichen Tools des Assistenten verwendet werden.

    ./install.sh

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

  3. Gemini CLI starten:

    gemini

  4. Mit dem Assistenten interagieren:Sie können jetzt Fragen stellen oder Befehle in natürlicher Sprache geben.

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 im Verzeichnis saved_code/ gespeichert.

  • Direkte API-Ausführung:Generierte schreibgeschützte Python-Skripts können direkt über gemini-cli ausgeführt werden. Die formatierten Ergebnisse werden im Terminal angezeigt. Nachdem der Assistant den Code generiert hat, wird eine Aufforderung auf dem Bildschirm angezeigt:

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>

Geben Sie run ein. Das Skript wird dann im Assistant-Kontext ausgeführt, wenn Ihre Standardsprache Python, Ruby oder PHP ist. Kompilierte Sprachen werden aufgrund von Sicherheitsrichtlinien nicht 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.

  • Unterstützung bei der Fehlerbehebung:Sie erhalten Hilfe bei Fehlermeldungen oder unerwartetem API-Verhalten.

    • Ich habe den Fehler „AuthenticationError.OAUTH_TOKEN_INVALID“ erhalten. Was soll ich tun?
    • „Warum sehe ich keine Ergebnisse für meine Anfrage?“

Beispielanwendungsfälle

  • Berichte:
    • „Gib mir die fünf wichtigsten Keywords nach Kosten für den letzten Monat für den Kunden 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 debuggen?“
  • 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.