Google Ads API Developer Assistant installieren und verwenden

Der Google Ads API Developer Assistant bietet umfassendes Fachwissen zur Google Ads API direkt in Ihrer KI-Programmierumgebung. Verwenden Sie Prompts in natürlicher Sprache und integrierte Slash-Befehle, um Abfragen zu erstellen, Clientbibliotheks-Code zu generieren, schreibgeschützte API-Aufrufe auszuführen, Ad-hoc-Berichte zu streamen und Probleme bei Integrationen zu beheben.

Der Assistant wurde als modulares Plug-in für die Agent-Frameworks Google Antigravity und Claude Code (Version 4.0.0) entwickelt. Er verwendet AGENTS.md- und CLAUDE.md-Verträge, integrierte Slash-Befehle und spezielle Fachkenntnisse, um einen dauerhaften Kontext, robuste Sicherheitsgrenzen und automatisierte Validierungspipelines zu gewährleisten.

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 zum 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 einbeziehen (--php, --ruby, --java, --dotnet oder --all).

Antigravity

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

Oder zusätzliche Clientbibliotheken einbeziehen:

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

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

Oder zusätzliche Clientbibliotheken einbeziehen:

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

Claude Code

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

Oder zusätzliche Clientbibliotheken einbeziehen:

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

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

Oder zusätzliche Clientbibliotheken einbeziehen:

.\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:Starten Sie Ihre 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 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 oder bestimmten Ressourcen. Der Assistant stützt seine Antworten auf offizielle API-Definitionen und nicht nur auf allgemeines LLM-Training.

    • „Was sind die verfügbaren Kampagnentypen?“
    • „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

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

    • „Zeige mir die Kampagnen mit den meisten Conversions in den letzten 30 Tagen.“
    • „Rufe alle aktivierten Namen von Anzeigengruppen für Kunde 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:Führen Sie komplexe Abfragen automatisch im Trockenlauf aus und validieren Sie sie anhand von API-Metadaten, Feldkompatibilität, Regeln für keine Impressionen und Datumssegmentierung, bevor Sie sie ausführen.

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

  • Objekt- und Protobuf-Schema prüfen:Prüfen Sie dynamisch Ressourcenstrukturen, verschachtelte Felder, Datentypen und Enum-Werte 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 Leistungsdaten in natürlicher Sprache ab. Der Assistant erstellt, validiert und führt GAQL-Abfragen direkt für Ihr Konto aus und streamt formatierte Live-Tabellen in das Terminal.

    • „Zeige die 5 wichtigsten Keywords nach Kosten im letzten Monat für Kunde 123-456-7890.“
    • „Speichere die Ergebnisse als CSV-Datei.“ Exportiert nach saved/csv/.

  • Direkte API-Ausführung und Mutate-Sicherheit:Führen Sie generierte schreibgeschützte Skripts direkt in einer verwalteten virtuellen Umgebung aus.

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

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

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

  • Zuordnung der Verwaltungskontohierarchie:Rufen Sie Kundennummern von Unterkonten ab und ordnen Sie Kontohierarchien unter einem Verwaltungskonto zu.

    • Claude Code: /get-cids <manager_cid>
    • Natürliche Sprache: „Rufe alle Kundennummern von Kunden unter Verwaltungskonto 123-456-7890 ab“

  • Performance Max-Kampagne-Eintragsfilter und -Ausschlüsse:Generieren Sie Produktaufteilungsbäume und URL-Ausschlüsse von Webseiten für Asset-Gruppen.

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

  • Zusätzlicher Codebasis-Kontext:Registrieren Sie Ihre Anwendungslogik und benutzerdefinierte Architektur in der Argumentation des Assistant.

    • 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 dieselben Funktionen über Prompts in natürlicher Sprache oder Namen von Skill-Tools wie validate_gaql und inspect_object aufrufen, wie unter Wichtige Features 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 das Hochladen von Offline-Conversions aus. /troubleshoot-conversions
/pmax-filter Generiert Performance Max-Eintragsfilter und -Ausschlüsse. /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-stufige 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 Assistant-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"

Starten Sie dann Ihre Antigravity-Hostsitzung neu.

Claude Code

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

Oder über Ihr 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 im GitHub-Repository in der CONTRIBUTING.md Datei.

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