Google-Ads-Konten und Kampagnen abfragen

Empfehlung

Der offizielle Google-Server taugt für Auswertungen aus Google Ads, wenn jemand mit Python- und Google-Cloud-Kenntnissen ihn aufsetzt. Er ist für den Selbstbetrieb gedacht, lokal oder als eigener Dienst in der Google Cloud. Beleg 2 Beleg 12

Nicht geeignet, wenn

• Die KI soll Gebote ändern, Kampagnen pausieren oder Anzeigen anlegen: Der Server liest nur. Beleg 12
• Es gibt niemanden mit Python- und Google-Cloud-Kenntnissen: Die Einrichtung läuft über pipx und ein Cloud-Projekt. Beleg 2 Beleg 12
• Dein Cloud-Projekt hat nur Test-Zugriff: Für Echtkonten braucht es mindestens die Stufe Explorer. Beleg 13

3 Abläufe zum Ausprobieren

Kopiere einen Prompt in deinen KI-Client und ersetze, was in eckigen Klammern steht. Lesende Abläufe ändern nichts im Dienst; bei schreibenden bestätigst du jede Änderung selbst.

1. Kampagne mit den höchsten Kosten im letzten Monat finden

   Für Anzeigenverantwortliche

   Liest nur Beleg 2 Beleg 12

   Prompt · ein Klick markiert den ganzen Text

   Liste die Google-Ads-Konten auf, auf die ich Zugriff habe. Welche Kampagne hat im letzten Monat in Konto [Kundennummer] am meisten gekostet? Nenne Kosten, Klicks und Conversions. Ändere nichts.

   Ergebnis

   Eine Kontenliste und eine Kampagnentabelle mit Kosten, Klicks und Conversions.

   Vorher prüfen

   Bei einem Manager-Konto brauchst du die Kundennummer. Prüfe Zeitraum und Konto in der Antwort, denn der Server fragt genau das ab, was die Anfrage vorgibt.

2. Kosten pro Conversion je Kampagne vergleichen

   Für Performance-Marketing

   Liest nur Beleg 12

   Prompt · ein Klick markiert den ganzen Text

   Rufe für Konto [Kundennummer] die Kosten, Klicks und Conversions je Kampagne der letzten 30 Tage ab, berechne die Kosten pro Conversion und ordne die Kampagnen danach. Ändere nichts.

   Ergebnis

   Eine geordnete Tabelle mit der berechneten Kennzahl je Kampagne.

   Vorher prüfen

   Die Kennzahl rechnet die KI selbst aus den abgefragten Werten. Rechne eine Zeile von Hand nach und vergleiche sie mit der Oberfläche von Google Ads.

3. Abfragbare Felder einer Ressource erklären lassen

   Für Einsteiger und alle, die eigene Berichte bauen

   Liest nur Beleg 2 Beleg 12

   Prompt · ein Klick markiert den ganzen Text

   Welche Felder stehen für die Ressource campaign zur Verfügung, die mit Kosten oder Conversions zu tun haben? Erkläre sie kurz und schlage eine Abfrage für einen Wochenbericht vor. Ändere nichts.

   Ergebnis

   Eine Liste von Feldern mit kurzer Erklärung und ein Vorschlag für eine Abfrage.

   Vorher prüfen

   Die Erklärung beruht auf den Feldern, die der Server liefert. Prüfe bei wichtigen Berichten die Feldnamen in der Google-Ads-Doku.

Das brauchst du

Tarif

Kein Tarif nötig; das Google-Cloud-Projekt braucht die API-Zugriffsstufe Explorer, Basic oder Standard.

Rolle

Jemand mit Python- und Google-Cloud-Kenntnissen richtet den Server ein; der angemeldete Benutzer braucht Zugriff auf die Google-Ads-Konten.

Zeitbedarf

ca. 30 Minuten, technische Hilfe sinnvoll

Schätzung der Redaktion

Belege

Beleg 2 Beleg 12 Beleg 13

Einrichtung je Client

Rechte

• Alle 7 Werkzeuge der belegten Liste fragen nur Daten ab.
• Der Anbieter deklariert: lesen.

Für die Werkzeuge reicht ein Konto mit Leserechten. Gib dem Baustein keine weitergehenden Rechte.

Nötig sind Google-Zugangsdaten mit dem Google-Ads-Scope für einen Benutzer, der auf die Konten zugreifen darf, und ein Google-Cloud-Projekt mit aktivierter Google Ads API. Einen Developer Token verlangt die neueste Serverversion laut Google nicht mehr.

Liest

Konten, Kampagnen, Budgets, Status und Kennzahlen, auf die der angemeldete Google-Benutzer zugreifen darf, sowie Feld-Metadaten und Referenzdaten der Google Ads API.

Ändert

Nichts, der Server arbeitet laut Google nur lesend.

Kann nicht

Gebote ändern, Kampagnen pausieren oder neue Assets anlegen. Konten, auf die der angemeldete Benutzer keinen Zugriff hat, bleiben unsichtbar.

Belege

Beleg 12 Beleg 2

Zugriffe laut Paketangaben

lesen

Authentifizierung

—

Transport

—

Technische Prüfung

Ungeprüft

Datenschutz

Was der Server kann

• Listet die Kunden-IDs und Kontonamen auf, auf die der angemeldete Benutzer Zugriff hat.
• Ruft per Abfrage in der Google Ads Query Language (GAQL) Kennzahlen, Budgets und Status aus einem Konto ab.
• Liefert Metadaten zu einem Ressourcentyp wie campaign, damit die KI weiß, welche Felder abfragbar sind.
• Stellt Referenzdaten der Google Ads API bereit, nämlich das Discovery-Dokument, die verfügbaren Metriken und Segmente sowie die Release-Notes.
• Arbeitet über ein Manager-Konto, wenn dessen Kundennummer als Login-Kunde angegeben wird.
• Lässt Werkzeuge über die Datei `tools_config.yaml` einzeln einschalten, ausschalten und mit einem Präfix versehen.

Belege Beleg 2 Beleg 12

Grenzen

• Der Server liest nur; Gebote ändern, Kampagnen pausieren oder neue Assets anlegen kann die KI laut Google nicht.
• Die README warnt, dass der Server deine Kontodaten dem angebundenen Agenten oder Sprachmodell zugänglich macht.
• Du betreibst den Server selbst, lokal über pipx oder als eigenen Cloud-Run-Dienst; im Cloud-Run-Beispiel der Anleitung ist der Dienst ohne Anmeldung am Aufruf erreichbar (Option `--allow-unauthenticated`), du solltest den Zugang also selbst prüfen.
• Developer Tokens wurden laut Google am 9. September 2026 eingestellt; die README führt sie noch als optional.

Belege Beleg 2 Beleg 12 Beleg 13

Wenn etwas nicht klappt

Die Abfrage scheitert mit dem Hinweis, das Cloud-Projekt sei nicht für den Produktivbetrieb freigegeben.

Dein Projekt hat nur Test-Zugriff und kann Echtkonten nicht abfragen. Beantrage auf der Übersichtsseite der Google Ads API für das Projekt die Zugriffsstufe Explorer. Beleg 13