Google Ads API Developer Assistant installieren und verwenden

Der Google Ads API Developer Assistant bringt umfassendes Google Ads API-Fachwissen direkt in Ihre KI-Programmierumgebung. Mit Prompts in natürlicher Sprache und integrierten Slash-Befehlen können Sie Abfragen erstellen, Clientbibliothekscode generieren, schreibgeschützte API-Aufrufe ausführen, Ad-hoc-Berichte streamen und Fehler in Integrationen beheben.

Der Assistant ist als modulares Plug-in für die Agent-Frameworks Google Antigravity und Claude Code (v4.0.0) konzipiert. Er verwendet AGENTS.md- und CLAUDE.md-Verträge, integrierte Slash-Befehle und spezialisierte Domain-Kenntnisse, um einen persistenten Kontext, robuste Sicherheitsgrenzen und automatisierte Validierungspipelines aufrechtzuerhalten. Eine Übersicht über die Architektur und das Design finden Sie unter Was ist der Google Ads API Developer Assistant?.

Vorbereitung

Bevor Sie beginnen, benötigen Sie Folgendes:

  1. Google Ads API-Zugriff:

  2. Software:

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) 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) im Verzeichnis $HOME 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 auch Ihre aktive API-Version in config/api_version.txt prüfen oder anpinnen.

4. Plug-in aktivieren

  • Antigravity: Starte deine Antigravity- / agy-Host-Sitzung 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 Assistant interagieren

Sie können mit dem Assistant über Prompts in natürlicher Sprache oder spezielle Slash-Befehle direkt in Ihrem Terminal interagieren.

Wichtige Features

  • Fragen und Antworten in natürlicher Sprache und konzeptionelle Anleitung: Stellen Sie Fragen zu Google Ads API-Funktionen, Architekturregeln, Best Practices oder bestimmten Ressourcen. Der Assistant fundiert seine Antworten auf offiziellen API-Definitionen, anstatt sich nur auf allgemeines LLM-Training zu verlassen.

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

  • Fundierte Codegenerierung für Clientbibliotheken: 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.“
    • „Rufe alle aktivierten Anzeigengruppennamen für den Kunden 123-456-7890 ab.“
    • „Schreibe Code, um eine Performance Max-Kampagne zu erstellen.“ 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-Schemaprüfung: Dynamische Prüfung von Ressourcenstrukturen, verschachtelten Feldern, Datentypen und Enum-Werten für jede aktive API-Version ohne Remote-Metadaten-Overhead.

    • 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 natürlicher Sprache. Der Assistent erstellt, validiert und führt GAQL-Abfragen direkt für Ihr Konto aus und streamt formatierte Tabellen live in das Terminal.

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

  • Direkte API-Ausführung und Sicherheit bei Änderungen: Generierte Scripts mit Lesezugriff können direkt in einer verwalteten virtuellen Umgebung ausgeführt werden.

    • Sagen Sie zu Assistant: „Führe den Code aus“ oder „Führe das Skript aus“.
    • Sicherheit bei Änderungen: Aus Sicherheitsgründen werden ändernde Vorgänge (Erstellen, Aktualisieren, Löschen) in saved/code/ generiert, aber nie direkt vom Assistenten ausgeführt. Prüfen Sie sie und führen Sie sie manuell außerhalb des Assistenten aus.

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

    • Claude Code: /troubleshoot-conversions
    • Natürliche Sprache: „Fehler bei Conversions für Kundennummer 123-456-7890 beheben.“ (Berichte werden in saved/data/ gespeichert).

  • Zuordnung der Verwaltungskontohierarchie:Kundennummern von Unterkonten abrufen und Kontohierarchien unter einem Verwaltungskonto zuordnen.

    • Claude Code: /get-cids <manager_cid>
    • Natürliche Sprache: „Alle Kundennummern von Zweitkunden unter dem Verwaltungskonto 123-456-7890 abrufen“

  • Eintragsfilter und Ausschlüsse für Performance Max-Kampagnen:Produktpartitionsbäume und Webseiten-URL-Ausschlüsse für Asset-Gruppen generieren.

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

  • Zusätzlicher Codebasis-Kontext: Registrieren Sie Ihre Anwendungslogik und benutzerdefinierte Architektur in der 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, stehen die folgenden integrierten Slash-Befehle zur Verfügung. In Google Antigravity können Sie diese Funktionen mit Prompts in natürlicher Sprache oder Skill-Tool-Namen wie validate_gaql und inspect_object aufrufen, wie unter Wichtige Funktionen beschrieben:

Slash-Befehl Zweck Beispiel
/validate-gaql Validiert GAQL-Syntax, -Kompatibilität und -Regeln. /validate-gaql
/inspect-object Prüft Protobuf-Felder, -Typen und -Enums. /inspect-object Campaign
/get-cids Löst Verwaltungskontohierarchien und Kunden-IDs auf. /get-cids 1234567890
/troubleshoot-conversions Führt eine Diagnose für den Upload von Offline-Conversions aus. /troubleshoot-conversions
/pmax-filter Generiert Filter und Ausschlüsse für Einträge in Performance Max-Kampagnen. /pmax-filter
/explain Liefert eine vierteilige strukturierte Erklärung. /explain shared set
/step-by-step Formuliert einen mehrphasigen Plan zur Aufgabenausführung. /step-by-step upload conversions
/assistant-tutorial Führt eine interaktive 11-Schritte-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"

Starten Sie dann die Antigravity-Hostsitzung neu.

Claude Code

In einer aktiven Claude Code-Sitzung:

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

Oder über Ihr Terminal:

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

(Optional) Entfernen Sie die lokale Marketplace-Registry:

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.

Nächste Schritte

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