Google Ads API Developer Assistant installieren und verwenden

Der Google Ads API Developer Assistant bietet Ihnen direkt in Ihrer KI-Programmierumgebung umfassendes Fachwissen zur Google Ads API. Mit Prompts in natürlicher Sprache und integrierten Schrägstrichbefehlen können Sie Abfragen erstellen, Clientbibliotheks-Code generieren, schreibgeschützte API-Aufrufe ausführen, Ad-hoc-Berichte streamen und Fehler bei Integrationen beheben.

Der Assistant wurde als modulares Plug-in für die Agent-Frameworks Google Antigravity und Claude Code (v4.0.0) entwickelt. Es verwendet AGENTS.md- und CLAUDE.md-Verträge, integrierte Slash-Befehle und spezielle Fachkenntnisse, um einen persistenten Kontext, robuste Sicherheitsgrenzen und automatisierte Validierungspipelines aufrechtzuerhalten.

Vorbereitung

Bevor Sie beginnen, benötigen Sie Folgendes:

  1. Google Ads API-Zugriff:

  2. Software:

    • Python 3.10 oder höher ist installiert und im PATH Ihres Systems enthalten. Python wird zum Ausführen von generiertem Code und zum Ausführen lokaler Validierungs-Sidecars verwendet.
    • Host-Agent-Plattform:
    • Git muss im PATH Ihres Systems installiert sein.

Jetzt starten

So klonen Sie das Repository, führen das plattformspezifische Installationsskript aus, konfigurieren Ihre Anmeldedaten und aktivieren das Plug-in:

1. Repository klonen

Klonen Sie das Repository auf Ihren lokalen Computer und rufen Sie das Projektverzeichnis auf:

git clone https://github.com/googleads/google-ads-api-developer-assistant
cd google-ads-api-developer-assistant

2. Installationsskript ausführen

Führen Sie das Installationsskript für Ihre Zielplattform aus. Standardmäßig ist die Python-Clientbibliothek enthalten. Optional können Sie zusätzliche Clientbibliotheken (--php, --ruby, --java, --dotnet oder --all) einfügen.

Antigravity

Linux / macOS:```bash ./install.sh agy

Oder fügen Sie zusätzliche Clientbibliotheken hinzu:

./install.sh agy --java --dotnet ```

Windows (PowerShell): ```powershell .\install.ps1 -Type agy

Oder fügen Sie zusätzliche Clientbibliotheken hinzu:

.\install.ps1 -Type agy -Java -Dotnet ```

Claude Code

Linux / macOS:```bash ./install.sh claude

Oder fügen Sie zusätzliche Clientbibliotheken hinzu:

./install.sh claude --php --dotnet ```

Windows (PowerShell): ```powershell .\install.ps1 -Type claude

Oder fügen Sie zusätzliche Clientbibliotheken hinzu:

.\install.ps1 -Type claude -Php -Dotnet ```

3. Anmeldedaten konfigurieren

Achten Sie darauf, dass sich Ihre API-Konfigurationsdatei (z. B. google-ads.yaml, google_ads_php.ini oder google_ads_config.rb) in Ihrem $HOME-Verzeichnis befindet.

(Optional) Wenn Sie eine Standardkundennummer konfigurieren möchten, geben Sie Ihre Kundennummer direkt in config/customer_id.txt ein (z. B. 1234567890). Sie können Ihre aktive API-Version auch in config/api_version.txt prüfen oder anpinnen.

4. Plug-in aktivieren

  • Antigravity:Starte deine Antigravity-/agy-Hostsitzung neu, um das Plug-in zu laden.
  • Claude Code:Führen Sie in einer aktiven Claude Code-Sitzung /reload-plugins aus oder starten Sie claude neu.

5. Mit dem Assistenten interagieren

Sie können mit Assistant über Prompts in natürlicher Sprache oder über spezielle Slash-Befehle direkt im Terminal 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.

  • Fragen und Antworten in natürlicher Sprache und konzeptionelle Anleitung:Sie können Fragen zu Google Ads API-Funktionen, Architekturregeln oder bestimmten Ressourcen stellen. Der Assistant stützt seine Antworten auf offizielle API-Definitionen und verlässt sich nicht nur auf das allgemeine LLM-Training.

    • Welche Kampagnentypen gibt es?
    • „Wie filtere ich in GAQL nach Datum?“
    • Erkläre den Unterschied zwischen „click_view“ und „impression_view“.
    • „Was ist ein gemeinsamer Satz und wie verwende ich ihn?“
    • Claude Code-Slash-Befehle:/explain, /step-by-step, /assistant-tutorial

  • Generierung von Clientbibliotheks-Code auf Grundlage von Informationen: Generieren Sie getesteten, idiomatischen Code mit offiziellen Google Ads-Clientbibliotheken (Python, Java, PHP, .NET und Ruby).

    • „Zeig mir die Kampagnen mit den meisten Conversions in den letzten 30 Tagen.“
    • „Get all enabled ad group names for customer 123-456-7890.“ (Rufe alle aktivierten Anzeigengruppennamen für den Kunden 123-456-7890 ab.)
    • „Schreibe Code zum Erstellen einer Performance Max-Kampagne.“ Der generierte Code wird im Verzeichnis saved/code/ gespeichert.

  • Programmatische GAQL-Abfragevalidierung:Komplexe Abfragen werden vor der Ausführung automatisch anhand von API-Metadaten, Feldkompatibilität, Regeln für Impressionen mit dem Wert „0“ und Datumssegmentierung getestet und validiert.

    • Claude Code:/validate-gaql
    • Natural Language:validate: SELECT campaign.id FROM campaign

  • Objekt- und Protobuf-Schema prüfen:Ressourcenstrukturen, verschachtelte Felder, Datentypen und Enum-Werte für jede aktive API-Version dynamisch prüfen, ohne dass Remote-Metadaten erforderlich sind.

    • Claude Code:/inspect-object <resource_or_enum>
    • Natürliche Sprache:„Kampagnenressource prüfen“

  • Ad-hoc-Live-Berichte und CSV-Export:Fragen Sie nach Leistungsdaten in einfachem Englisch. Der Assistant erstellt, validiert und führt GAQL-Abfragen direkt für Ihr Konto aus und streamt formatierte Tabellen live in das Terminal.

    • „Show top 5 keywords by cost last month for customer 123-456-7890.“ (Zeige die 5 wichtigsten Keywords nach Kosten für den Kunden 123-456-7890 im letzten Monat.)
    • „Speichere die Ergebnisse als CSV-Datei.“ (Export nach saved/csv/)

  • Direkte API-Ausführung und Mutate-Sicherheit:Generierte schreibgeschützte Skripts können direkt in einer verwalteten virtuellen Umgebung ausgeführt werden.

    • Sagen Sie einfach zu Assistant: „Führe den Code aus“ oder „Führe das Script aus“.
    • Sicherheitsänderung: Aus Sicherheitsgründen werden Änderungsoperationen (Erstellen, Aktualisieren, Löschen) für saved/code/ generiert, aber nie direkt vom Assistenten ausgeführt. Sie müssen sie manuell außerhalb des Assistenten prüfen und ausführen.

  • Erweiterte Diagnose und Fehlerbehebung bei Conversions:Sie können Fehler beim Hochladen von Offline-Conversions untersuchen, Upload-Dateien vorab validieren und detaillierte Diagnoseberichte erstellen.

    • Claude Code:/troubleshoot-conversions
    • Natürliche Sprache:„Finde die Ursache für Conversion-Probleme für Kunde 123-456-7890.“ Berichte werden in saved/data/ gespeichert.

  • Zuordnung der Verwaltungskontohierarchie:Kunden-IDs von untergeordneten Konten abrufen und Kontohierarchien unter einem Verwaltungskonto zuordnen.

    • Claude Code:/get-cids <manager_cid>
    • Natürliche Sprache:„Get all client customer IDs under manager 123-456-7890“ (Rufe alle Kunden-IDs unter der Verwaltungs-ID 123-456-7890 ab.)

  • Filter und Ausschlüsse für Einträge in Performance Max-Kampagnen:Erstellen Sie Produktpartitionsbäume und schließen Sie Webseiten-URLs für Asset-Gruppen aus.

    • Claude Code:/pmax-filter
    • Natürliche Sprache:„Erstelle Ausschlussfilter für Webseiten für meine Performance Max-Kampagne.“

  • Zusätzlicher Kontext für die Codebasis:Registrieren Sie Ihre Anwendungslogik und benutzerdefinierte Architektur in der Argumentation des Assistenten.

    • Linux / macOS:bash ./update.sh agy --context_dir /path/to/your/codebase # Or for Claude Code: ./update.sh claude --context_dir /path/to/your/codebase
    • Windows (PowerShell): powershell .\update.ps1 -Type agy -ContextDir C:\path\to\your\codebase

Referenz zu Claude-Code-Slash-Befehlen

Wenn Sie Claude Code verwenden, sind die folgenden integrierten Slash-Befehle verfügbar. In Google Antigravity können Sie diese Funktionen mit Prompts in natürlicher Sprache oder mit Namen von Skill-Tools wie validate_gaql und inspect_object aufrufen, wie unter Wichtige Funktionen beschrieben:

Slash-Befehl Zweck Beispiel
/validate-gaql Validiert die GAQL-Syntax, ‑Kompatibilität und ‑Regeln. /validate-gaql
/inspect-object Untersucht Protobuf-Felder, ‑Typen und ‑Enumerationen. /inspect-object Campaign
/get-cids Löst MCC-Hierarchien und Client-CIDs auf. /get-cids 1234567890
/troubleshoot-conversions Führt eine Diagnose für den Upload von Offline-Conversions aus. /troubleshoot-conversions
/pmax-filter Erstellt Filter und Ausschlüsse für Performance Max-Kampagnen. /pmax-filter
/explain Liefert eine strukturierte Erklärung in vier Teilen. /explain shared set
/step-by-step Formuliert einen mehrphasigen Plan zur Ausführung von Aufgaben. /step-by-step upload conversions
/assistant-tutorial Führt eine interaktive 11‑Schritt-Anleitung aus. /assistant-tutorial

Wartung und Updates

So aktualisieren Sie das Repository, die Plug-in-Installation und die Clientbibliotheken:

Antigravity

Linux / macOS:bash ./update.sh agy # Update Antigravity plugin ./update.sh agy --all # Include all client libraries

Windows (PowerShell): powershell .\update.ps1 -Type agy .\update.ps1 -Type agy -All

Claude Code

Linux / macOS:bash ./update.sh claude # Update Claude Code plugin ./update.sh claude --all # Include all client libraries

Windows (PowerShell): powershell .\update.ps1 -Type claude .\update.ps1 -Type claude -All

Deinstallation

So deinstallieren Sie das Assistenten-Plug-in:

Antigravity

Linux / macOS:bash rm -rf ~/.gemini/config/plugins/google-ads-api-developer-assistant

Windows (PowerShell): powershell Remove-Item -Recurse -Force "$HOME\.gemini\config\plugins\google-ads-api-developer-assistant"

Starte dann die Antigravity-Host-Sitzung neu.

Claude Code

In einer aktiven Claude Code-Sitzung: none /plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

Oder über das Terminal: bash claude plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

Optional: Entfernen Sie die lokale Marketplace-Registrierung: bash claude plugin marketplace remove google-ads-assistant-local

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?