Google Ads API Developer Assistant 3.0.0

Mittwoch, 10. Juni 2026

wir freuen uns, die Veröffentlichung von Version 3.0.0 des Google Ads API Developer Assistant bekannt zu geben. Diese Hauptversion ist ein wichtiger Meilenstein in der Entwicklung des Assistant. Der Schwerpunkt liegt auf der Modernisierung der Architektur, einer verbesserten Zuverlässigkeit und einem modulareren Design.

Mit diesem Release migrieren wir den Assistenten zum Google Antigravity-Agenten-Framework und stellen auf eine kompetenzbasierte Architektur um. Diese Änderungen machen den Assistenten robuster, einfacher zu warten und reduzieren die Tokennutzung.

Was ist neu in Version 3.0.0?

1. Unterstützt durch das Antigravity-Framework

Der Google Ads API Developer Assistant wurde von gemini-cli zum Antigravity-Agenten-Framework (v3.0.0) migriert. Dieses Upgrade des zugrunde liegenden Frameworks bietet eine strukturiertere und zuverlässigere Ausführungsumgebung. Außerdem wurde die Verzeichnis- und Dateistruktur des Projekts aktualisiert, um es vollständig für Antigravity vorzubereiten.

Der Support für gemini-cli wird am 18. Juni 2026 eingestellt, wie in dieser Google-Blogankündigung beschrieben.

2. Eine modulare, kompetenzbasierte Architektur

Wir haben die Kernfunktionen von Assistant in Skills umgewandelt. Anstatt sich auf allgemeine, unstrukturierte Anweisungen in einer Kontextdatei zu verlassen, lädt der Assistent jetzt bei Bedarf dynamisch spezialisierte, getestete Toolverzeichnisse (Skills). Dadurch werden „Halluzinationen“ drastisch reduziert und Aufgaben werden mit präzisen, verifizierten Verfahren ausgeführt.

Zu den wichtigsten Neuerungen dieser modularen Umstellung gehören:

  • GAQL-Validierung (validate_gaql): In einen dedizierten Skill verschoben. Sie enthält jetzt erweiterte statische Abfrageprüfungen für Datumssegmente, click_view-Filter für einzelne Tage und change_status-Grenzwerte.
  • Fehlerbehebung bei Conversions (troubleshoot_conversions): Ersetzt die alte conversions_support_package. Es fasst alle Skripts und Tests zur Fehlerbehebung bei Conversions und zur Zusammenfassung von Uploads in einem einzigen, einheitlichen Skill-Verzeichnis zusammen.
  • Strukturierte Befehle (explain und step_by_step): Werden in Skills umgewandelt, um einheitliche, strukturierte Layouts für Erklärungen zu erzwingen.
  • Neue Kontozuordnung (get_cids_under_mcc): Ein neuer Skill zum Abrufen aller untergeordneten Konten unter einem Verwaltungskonto (Kundencenter).
  • Neue Objektprüfung (inspect_object): Eine neue Fähigkeit zum dynamischen Abrufen von Protobuf-Nachrichten und Enums, damit der Assistant immer die richtigen Strukturen verwendet.
  • Neuer Filter für Performance Max-Einträge (pmax_listing_filter): Eine neue Fähigkeit, mit der Änderungen am Baum für den Ausschluss von Webseiten in Eintragsgruppen für Performance Max-Kampagnen standardisiert werden können.

3. Mehr Konsistenz und Genauigkeit

Wir haben strengere Regeln und Anforderungen eingeführt, um eine hochwertige Codegenerierung und Abfragevalidierung zu gewährleisten:

  • Explizite API-Versionsverwaltung: Für wichtige Skills wie get_cids_under_mcc, validate_gaql und troubleshoot_conversions ist jetzt ein explizites api_version-Argument erforderlich, um Unklarheiten zu vermeiden.
  • Strikte GAQL-Regeln:
    • Es wurde eine Regel zu AGENTS.md hinzugefügt, um die Verwendung von SQL-Aggregatfunktionen (z. B. SUM, COUNT und AVG) in GAQL-Abfragen zu verhindern, da sie nicht unterstützt werden.
    • Es wurde eine Regel hinzugefügt, nach der zuerst die Versionshinweise auf der Google Ads API-Entwicklerwebsite für die aktuelle API-Version geprüft werden, damit der Assistant aktuelle Dokumentation verwendet.
    • Optimierte Konfiguration: AGENTS.md wurde optimiert, was zu einem kleineren anfänglichen Kontextfenster führt. Die Dokumentation zu doppelten Conversions wurde zugunsten von programmatischen Fähigkeiten entfernt.

4. Verbesserungen der Developer Experience (DX)

Wir haben mehrere Verbesserungen vorgenommen, um die Entwicklung zu beschleunigen und zu vereinfachen:

  • Persistente virtuelle Umgebung (.venv): Die virtuelle Umgebung wird am Ende einer Sitzung nicht mehr gelöscht. Beim Start prüft der Assistent die Python-Version Ihres Systems. Die .venv wird nur neu erstellt, wenn eine neuere Python-Version verfügbar ist.
  • Intelligentes Caching der API-Version: Der Assistent speichert jetzt die aktuelle Google Ads API-Version mit einer TTL von 19 Stunden im Cache. Dadurch werden redundante Netzwerkprüfungen vermieden und die Startzeit wird verkürzt.
  • Besseres Debugging mit persistenten Logs: Logeinträge enthalten jetzt Datums- und Zeitstempel. Die Protokolldatei wird in das Verzeichnis .agents/ geschrieben und nicht mehr bei jeder Ausführung zurückgesetzt. So bleibt der Verlauf für die Fehlerbehebung erhalten.

Warum sollten Sie ein Upgrade ausführen?

Beim Upgrade auf Version 3.0.0 geht es in erster Linie um Zuverlässigkeit und Struktur. Durch die Umstellung auf das Antigravity-Framework und die Modularisierung von Funktionen in Skills haben wir Assistant berechenbarer und ressourceneffizienter gemacht.

Wenn Sie einen schnelleren Start, eine zuverlässigere GAQL-Validierung und eine robustere Fehlerbehebung wünschen, empfehlen wir ein Upgrade auf Version 3.0.0.

Jetzt starten

Erstinstallation

  1. Antigravity CLI installieren: Folgen Sie der Anleitung unter https://antigravity.google/.
  2. Assistenten klonen: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. Installationsskript ausführen:
    • Linux/macOS: Führen Sie ./install.sh aus (standardmäßig wird Python unterstützt, verwenden Sie Flags wie --php oder --ruby für andere Sprachen).
    • Windows: Öffnen Sie PowerShell und führen Sie .\install.ps1 aus.

Upgrade von v2.x ausführen

  1. Kopieren Sie benutzerdefinierten Code oder Daten aus saved/ an einen sicheren Ort außerhalb des Projektverzeichnisses.
  2. Löschen Sie Ihren lokalen Klon des Assistenten.
  3. Klonen Sie das Repository:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. Führen Sie das Installationsskript (install.sh oder install.ps1) aus, um die neue Antigravity-Umgebung zu initialisieren.

Bob Hancock, Google Ads API-Team

Labels: google-ads-api, release