Google Ads API Explorer

Der Google Ads API Explorer ist eine interaktive Ausführungsumgebung, in der Sie Live-API-Anfragen direkt in Ihrem Browser erstellen und senden können. Es ist in die Referenzdokumentation eingebettet und kümmert sich um die Komplexität der OAuth 2.0-Authentifizierung und der Formatierung von JSON-Nutzlasten. So können Sie bestimmte Dienste und Methoden testen, ohne eine einzige Zeile Code schreiben zu müssen.

Vorteile

  • No-Code-Tests:Führen Sie Live-API-Aufrufe (sowohl Lese- als auch Schreibvorgänge) direkt über die Dokumentation aus, ohne eine lokale Entwicklungsumgebung einrichten zu müssen.
  • Protokollerkennung:Sehen Sie sich die genaue Struktur von HTTP-Anfragen und ‑Antworten an, um zu verstehen, wie sich die API verhält.
  • Prototyping mit geringem Aufwand:Sie können das Endpunktverhalten überprüfen und Roh-API-Antworten einsehen, bevor Sie die Logik in Ihrer Anwendung implementieren.
  • Vereinfachte Authentifizierung:Das Tool verwaltet OAuth 2.0-Vorgänge automatisch, sodass Sie sich auf die API-Anfrage und nicht auf die Verwaltung von Anmeldedaten konzentrieren können.

Jetzt starten

  1. Dokumentation aufrufen:Rufen Sie die Referenzdokumentation auf und wählen Sie den Dienst und die Methode aus, die Sie testen möchten, z. B. GoogleAdsService/Search.
  2. Explorer öffnen:Suchen Sie rechts auf der Seite nach dem Bereich Diese Methode testen.
  3. Anfrage konfigurieren:
    • Geben Sie die erforderlichen Anfrageparameter wie customerId ein und maximieren Sie Header, um optionale HTTP-Header wie login-customer-id anzugeben (nur erforderlich, wenn Sie über ein Verwaltungskonto auf ein Konto zugreifen). Entwicklertokens (developer-token) wurden am 9. September 2026 eingestellt und werden von API-Servern ignoriert. Sie können aber weiterhin einen Wert eingeben, wenn Sie im Formular dazu aufgefordert werden.
    • Definieren Sie den Anfragetext mit dem interaktiven JSON-Editor, wenn für die Methode eine Nutzlast erforderlich ist, z. B. für search- oder mutate-Vorgänge.
  4. Ausführen:Klicken Sie auf Ausführen, um die Anfrage zu senden. Das Tool zeigt die vollständige HTTP-Anfrage und die Live-JSON-Antwort der API an.

Wichtige Features

  • Live-Ausführung:Führen Sie search- und mutate-Vorgänge in Echtzeit für Ihre Produktions- oder Testkonten aus.
  • Formatierung von JSON-Nutzlasten:Komplexe JSON-Objekte für Anfragen lassen sich interaktiv erstellen. Das Tool hebt erforderliche Felder und gültige Schemastrukturen hervor.
  • Feldmasken:Testen Sie die update_mask-Logik, um zu sehen, wie sich partielle Ressourcenaktualisierungen in der Praxis verhalten.
  • Fehlerüberprüfung:Detaillierte Fehlermeldungen und ‑codes (z. B. QUERY_ERROR oder AUTHENTICATION_ERROR) in der Rohantwort erleichtern das Debugging.
  • Code exportieren:Exportieren Sie curl-Befehle, Roh-HTTP-Anfragen oder JavaScript-Beispielcode aus der maximierten Ansicht des API Explorers.

Beispielanwendungsfälle

  • Kontoeinstellungen prüfen:Mit einer GoogleAdsService/Search-Anfrage an die customer-Ressource lassen sich Konfigurationen oder Metadaten auf Kontoebene schnell abrufen.
  • Mutationen testen:Prüfen Sie, ob die Kampagnenerstellung oder Budgetaktualisierung erfolgreich war, bevor Sie den Code in der Produktion bereitstellen.
  • GAQL debuggen:Verwenden Sie den Explorer, um einen GAQL-String (Google Ads Query Language) auszuführen und zu prüfen, ob die zurückgegebene JSON-Struktur den Erwartungen Ihrer Anwendung entspricht.
  • Protokollüberprüfung:Sehen Sie sich die genauen HTTP-Header und die JSON-Verschachtelung an, die für eine bestimmte API-Version erforderlich sind.