Google Ads API: Einführung für Entwickler und Agenturen

Q: Wie lange dauert es, API-Zugang zu bekommen?

**Basic Access wird innerhalb von 1–5 Werktagen** gewährt. Standard Access erfordert mehrere Wochen bis Monate – abhängig von Use Case und Vollständigkeit der Bewerbung.

Q: Welche Programmiersprache ist am besten?

**Python ist die beliebteste Wahl für Google Ads API-Entwicklung** – vollständige Dokumentation, große Community, ideal für Datenverarbeitung. Java eignet sich für Enterprise-Umgebungen, PHP für WordPress- und Website-Integrationen. Die Sprache des eigenen Teams hat Vorrang vor abstrakten Empfehlungen.

Die Google Ads API ist die leistungsstärkste Schnittstelle für programmatischen Zugriff auf Google Ads. Die Weboberfläche und Google Ads Scripts decken Standardanforderungen ab – die API erschließt 100 % der Plattformfunktionalität für große Agenturen, Tool-Entwickler und Unternehmen mit komplexen Automatisierungsanforderungen.

Was ist die Google Ads API?

Die Google Ads API ist eine REST-basierte Programmierschnittstelle mit vollständigem Zugriff auf alle Google Ads-Funktionen. Sie automatisiert das Erstellen, Lesen, Aktualisieren und Löschen von Kampagnen, Keywords, Anzeigen und allen weiteren Entitäten – ohne manuelle Eingriffe in die Weboberfläche.

Definition und Funktionsumfang

Was ist eine API? Eine Application Programming Interface ermöglicht Software-zu-Software-Kommunikation. Ihre Anwendung sendet HTTP-Anfragen an Googles Server, die strukturierte Daten zurückgeben oder Änderungen durchführen – ohne manuelle Aktionen in der Weboberfläche.

Funktionsumfang der Google Ads API:

Vollständiges Kampagnen-Management: Erstellen, bearbeiten, pausieren, löschen
Reporting und Analytics: Abrufen von Performance-Daten mit flexiblen GAQL-Queries
Bidding und Budget-Management: Programmatische Gebotsanpassungen
Audience Management: Erstellen und verwalten von Zielgruppen
Asset-Management: Upload und Verwaltung von Bildern, Videos und anderen Assets
Bulk-Operationen: Bis zu 10.000 Änderungen an Entitäten pro Batch-Request
Echtzeit-Zugriff: Keine Wartezeiten wie bei Looker Studio oder manuellen Reporting-Tools

API-Versionen: Google veröffentlicht regelmäßig neue API-Versionen mit erweiterten Features. 2026 ist Version 16 aktuell, mit Backwards-Kompatibilität für ausgewählte ältere Versionen.

API vs. Scripts vs. Editor

Die Google Ads API, Google Ads Scripts und der Google Ads Editor adressieren 3 unterschiedliche Automatisierungsniveaus – die Wahl hängt vom Skalierungsbedarf ab.

Google Ads API:

Beste für: Custom-Tool-Entwicklung, große Agenturen, komplexe Integrationen
Vorteile: Vollständiger Funktionsumfang, keine Laufzeit-Limits, externes Hosting
Nachteile: Komplexer Setup, Developer Token erforderlich, steile Lernkurve
Use Case: Eigenes Bid-Management-Tool, Cross-Platform-Dashboard, White-Label-Lösung

Google Ads Scripts:

Beste für: Automatisierung in einzelnen Konten, kleine bis mittlere Agenturen
Vorteile: Einfacher Start, läuft auf Google-Servern, integriert in Google Ads UI
Nachteile: 30-Minuten-Laufzeit-Limit, JavaScript-only, eingeschränkter Funktionsumfang gegenüber der API
Use Case: Tägliche Reports, Budget-Monitoring, einfache Optimierungen

Google Ads Editor:

Beste für: Bulk-Bearbeitung durch Menschen, Offline-Arbeit
Vorteile: Keine Programmierung, Desktop-App, mächtige Bulk-Funktionen
Nachteile: Keine Automatisierung, manuelle Nutzung erforderlich
Use Case: Große Account-Umstrukturierungen, Kampagnen-Duplikation

Entscheidungshilfe: Google Ads Scripts sind der richtige Einstieg für die meisten Automatisierungsanforderungen. Die API wird notwendig, sobald das 30-Minuten-Laufzeit-Limit greift, der Funktionsumfang nicht ausreicht oder ein kommerzielles Tool entsteht.

API-Zugang beantragen

Der Zugang zur Google Ads API erfordert einen mehrstufigen Bewerbungsprozess, den Google zur Missbrauchsprävention kontrolliert.

Voraussetzungen

Vor der Antragstellung sind 4 Voraussetzungen zu erfüllen:

Google Ads Konto: Ein aktives Google Ads Konto – auch ein Test-Konto genügt
Developer-Skills: Grundkenntnisse in mindestens einer Programmiersprache (Python, Java, PHP)
Use Case: Eine konkrete, dokumentierte Beschreibung des geplanten Einsatzzwecks
Compliance-Verständnis: Kenntnisse der API Terms & Conditions

Developer Token beantragen

Der Developer Token ist der primäre Zugangsschlüssel zur Google Ads API und wird über das API Center im Google Ads-Konto beantragt.

Melden Sie sich bei Google Ads an – bevorzugt in einem Manager-Konto (MCC)
Klicken Sie auf „Tools und Einstellungen" → „Setup" → „API Center"
Klicken Sie auf „Developer Token beantragen"
Füllen Sie das Antragsformular mit diesen 3 Pflichtangaben aus:
- Firmenname und Website
- Beschreibung Ihres Use Cases: Konkret formulieren – „Custom Reporting Dashboard für 50 Agentur-Kunden" überzeugt, „Automatisierung" wird abgelehnt
- Erwartetes Request-Volumen: Realistisch schätzen
Stimmen Sie den Terms zu und senden Sie die Anfrage ab

Bearbeitungszeit: Google prüft Anträge innerhalb von 1–5 Werktagen. In Einzelfällen fordert Google zusätzliche Informationen an, was den Prozess verlängert.

OAuth 2.0 einrichten

OAuth 2.0 Credentials sind zusätzlich zum Developer Token für jede API-Authentifizierung erforderlich. Die Einrichtung erfolgt in 5 Schritten über die Google Cloud Console.

Besuchen Sie die Google Cloud Console
Erstellen Sie ein neues Projekt oder wählen Sie ein bestehendes
Aktivieren Sie die „Google Ads API" für Ihr Projekt:
- „APIs & Services" → „Library" → „Google Ads API" suchen → „Enable"
Erstellen Sie OAuth 2.0 Credentials:
- „APIs & Services" → „Credentials" → „Create Credentials" → „OAuth client ID"
- Application type: „Desktop app" für lokale Entwicklung, „Web application" für gehostete Apps
- Client ID und Client Secret notieren
Autorisieren Sie Ihre Anwendung über Googles OAuth 2.0 Flow, um ein Refresh Token zu erhalten – die Client Libraries stellen dafür Helper-Functions bereit

Sicherheit: Client Secret und Refresh Token sind wie Passwörter zu behandeln. Niemals in öffentliche Repositories committen.

Zugangslevels (Basic vs. Standard)

Google Ads API-Zugang existiert in 2 Levels mit grundlegend unterschiedlichen Einsatzmöglichkeiten.

Basic Access (Test-Level):

Automatisch vergeben während der Prüfungsphase
Funktioniert ausschließlich mit Test-Konten und dem antragstellenden Konto
Limit: Wenige Tausend API-Anfragen pro Tag
Keine Produktions-Nutzung möglich
Zweck: Entwicklung und Testing

Standard Access (Production-Level):

Vergeben nach erfolgreicher Prüfung durch Google
Funktioniert mit allen Google Ads-Konten, zu denen Zugriff besteht
Limit: Millionen Anfragen pro Tag
Für Live-Produktions-Nutzung freigegeben
Voraussetzung: Nachweisbare legitime Use Cases, vollständige Policy-Compliance

Upgrade-Prozess: Nach der Entwicklungsphase mit Basic Access erfolgt die Bewerbung für Standard Access. Google prüft Anwendung und Use Cases – dieser Prozess dauert mehrere Wochen und erfordert detaillierte Implementierungsdokumentation.

Erste Schritte mit der API

Google Ads Client Libraries für 5 Programmiersprachen reduzieren den Implementierungsaufwand erheblich und sind der empfohlene Einstiegspunkt nach erfolgreicher Zugangsgenehmigung.

Client Libraries installieren

Google pflegt offizielle Libraries für diese 5 Sprachen:

Python (empfohlen für Einsteiger):

pip install google-ads

Java:

# Maven Dependency
<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>LATEST_VERSION</version>
</dependency>

PHP:

composer require googleads/google-ads-php

Ruby:

gem install google-ads-googleads

.NET:

Install-Package Google.Ads.GoogleAds

Empfehlung: Python ist die beliebteste Wahl für Google Ads API-Entwicklung. Die Library ist vollständig dokumentiert, die Community umfasst Tausende aktiver Entwickler, und Python eignet sich ideal für Datenverarbeitung und Analytics-Workflows.

Authentifizierung

Die google-ads.yaml-Konfigurationsdatei zentralisiert alle 5 erforderlichen Authentifizierungsparameter und wird von den Client Libraries automatisch eingelesen.

# Google Ads API Configuration
developer_token: INSERT_DEVELOPER_TOKEN_HERE
client_id: INSERT_OAUTH2_CLIENT_ID_HERE
client_secret: INSERT_OAUTH2_CLIENT_SECRET_HERE
refresh_token: INSERT_REFRESH_TOKEN_HERE
login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE

Parameter-Erklärung:

developer_token: Ihr Developer Token aus dem API Center
client_id und client_secret: OAuth Credentials aus der Google Cloud Console
refresh_token: OAuth Refresh Token – einmalig durch den Authorization Flow generiert
login_customer_id: Customer ID des Manager-Kontos bei MCC-Nutzung (optional)

Erste Abfrage durchführen

Dieses Python-Beispiel ruft die Top-10-Kampagnen nach Impressions der letzten 30 Tage ab und validiert gleichzeitig das gesamte API-Setup.

from google.ads.googleads.client import GoogleAdsClient

# Client initialisieren (liest google-ads.yaml)
client = GoogleAdsClient.load_from_storage("google-ads.yaml")

# Customer ID des Kontos, das Sie abfragen möchten
customer_id = "1234567890"  # Ohne Bindestriche

# Google Ads Service abrufen
ga_service = client.get_service("GoogleAdsService")

# Query für Kampagnen
query = """
    SELECT
        campaign.id,
        campaign.name,
        campaign.status,
        metrics.impressions,
        metrics.clicks,
        metrics.cost_micros
    FROM campaign
    WHERE segments.date DURING LAST_30_DAYS
    ORDER BY metrics.impressions DESC
    LIMIT 10
"""

# Query ausführen
response = ga_service.search(customer_id=customer_id, query=query)

# Ergebnisse ausgeben
print("Top 10 Kampagnen nach Impressions:")
for row in response:
    campaign = row.campaign
    metrics = row.metrics

    cost_eur = metrics.cost_micros / 1_000_000  # Micros zu EUR

    print(f"Kampagne: {campaign.name}")
    print(f"  Status: {campaign.status.name}")
    print(f"  Impressions: {metrics.impressions}")
    print(f"  Clicks: {metrics.clicks}")
    print(f"  Cost: {cost_eur:.2f} EUR")
    print()

Das Script durchläuft 5 Schritte:

Client initialisieren mit Credentials aus google-ads.yaml
GoogleAdsService laden – den primären Service für alle GAQL-Queries
GAQL-Query (Google Ads Query Language) definieren und Datenselektion festlegen
Query ausführen und Serverantwort empfangen
Ergebnisse iterieren und strukturiert ausgeben

Erfolgskriterium: Ein fehlerfreier Lauf mit sichtbaren Kampagnendaten bestätigt ein funktionsfähiges API-Setup.

API Use Cases

Die Google Ads API löst 5 Anwendungsfälle, die mit Google Ads Scripts oder dem Google Ads Editor nicht skalierbar umsetzbar sind.

Kampagnen-Management automatisieren

Szenario: Sie verwalten Hunderte Kampagnen mit identischen Strukturen und synchronisieren sie täglich.