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:

Jetzt starten

Führen Sie die folgenden Schritte aus, um das Repository zu klonen, das plattformspezifische Installationsskript auszuführen, Ihre Anmeldedaten zu konfigurieren und das Plug-in zu aktivieren.

1. Repository klonen

Klonen Sie das Repository auf Ihren lokalen Computer und wechseln Sie in das Projektverzeichnis:

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) einbinden.

Antigravity

Linux / macOS:

./install.sh agy
# Or include additional client libraries:
./install.sh agy --java --dotnet

Windows (PowerShell):

.\install.ps1 -Type agy
# Or include additional client libraries:
.\install.ps1 -Type agy -Java -Dotnet

Claude Code

Linux / macOS:

./install.sh claude
# Or include additional client libraries:
./install.sh claude --php --dotnet

Windows (PowerShell):

.\install.ps1 -Type claude
# Or include additional client libraries:
.\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 Standard-Kundennummer 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 in Ihrem Terminal interagieren.

Wichtige Features

  • Fragen und Antworten in natürlicher Sprache und konzeptionelle Anleitung:Sie können Fragen zu Google Ads API-Funktionen, Architekturregeln, Best Practices oder bestimmten Ressourcen stellen. Der Assistant stützt 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 gemeinsames Set und wie verwende ich es?“
    • Claude Code-Slash-Befehle:/explain, /step-by-step, /assistant-tutorial

  • Generierung von Clientbibliotheks-Code auf Grundlage von Kontext: 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 Null-Impressionen und Datumssegmentierung getestet und validiert.

    • Claude Code:/validate-gaql
    • Natürliche Sprache: validate: SELECT campaign.id FROM campaign

  • Objekt- und Protobuf-Schema prüfen:Sie können Ressourcenstrukturen, verschachtelte Felder, Datentypen und Enumerationswerte 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.

    • „Zeige die fünf wichtigsten Keywords nach Kosten für den Kunden 123-456-7890 im letzten Monat an.“
    • „Speichere die Ergebnisse als CSV-Datei.“ (Exporte nach saved/csv/)

  • Direkte API-Ausführung und Mutate-Sicherheit:Generierte schreibgeschützte Skripts direkt in einer verwalteten virtuellen Umgebung ausführen.

    • Sagen Sie zu Assistant: „Führe den Code aus“ oder „Führe das Script aus“.
    • Sicherheitsänderungen: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: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 Manager-ID 123-456-7890 ab)

  • Filter und Ausschlüsse für Performance Max-Kampagnen-Einträge:Erstellen Sie Produktaufteilungsbä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 für die Argumentation des Assistenten.

    • Linux / macOS:

      ./update.sh agy --context_dir /path/to/your/codebase
# Or for Claude Code:
./update.sh claude --context_dir /path/to/your/codebase

    • Windows (PowerShell):

      .\update.ps1 -Type agy -ContextDir C:\path\to\your\codebase

Referenz zu Slash-Befehlen für Claude-Code

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 Überprüft die GAQL-Syntax, ‑Kompatibilität und ‑Regeln. /validate-gaql
/inspect-object Untersucht Protobuf-Felder, ‑Typen und ‑Enumerationen. /inspect-object Campaign
/get-cids Löst Kundencenter-Hierarchien und Client-CIDs auf. /get-cids 1234567890
/troubleshoot-conversions Führt eine Diagnose für das Hochladen von Offline-Conversions aus. /troubleshoot-conversions
/pmax-filter Erstellt Filter und Ausschlüsse für Performance Max-Anzeigen. /pmax-filter
/explain Liefert eine vierteilige strukturierte Erklärung. /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:

./update.sh agy          # Update Antigravity plugin
./update.sh agy --all    # Include all client libraries

Windows (PowerShell):

.\update.ps1 -Type agy
.\update.ps1 -Type agy -All

Claude Code

Linux / macOS:

./update.sh claude       # Update Claude Code plugin
./update.sh claude --all # Include all client libraries

Windows (PowerShell):

.\update.ps1 -Type claude
.\update.ps1 -Type claude -All

Deinstallation

So deinstallieren Sie das Assistant-Plug-in:

Antigravity

Linux / macOS:

rm -rf ~/.gemini/config/plugins/google-ads-api-developer-assistant

Windows (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:

/plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

Oder über das Terminal:

claude plugin uninstall \
  google-ads-api-developer-assistant@google-ads-assistant-local

(Optional) Entfernen Sie die lokale Marketplace-Registrierung:

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?