Google Ads API Explorer

Der Google Ads API Explorer ist eine interaktive Ausführungsumgebung, mit der Sie Live-API-Anfragen direkt in Ihrem Browser erstellen und senden können. Es ist in die Referenzdokumentation eingebettet und übernimmt die komplexen Aufgaben der OAuth 2.0-Authentifizierung und der JSON-Nutzlastformatierung. 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 Schreibaufrufe) direkt aus der Dokumentation aus, ohne eine lokale Entwicklungsumgebung einrichten zu müssen.
  • Protokollerkennung: Sie können die genaue Struktur von HTTP-Anfragen und -Antworten sehen, um das Verhalten der API zu verstehen.
  • Reibungslose Prototyperstellung: Überprüfen Sie das Endpunktverhalten und prüfen Sie die API-Rohantworten, 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. Konfigurieren Sie die Anfrage:
    • Geben Sie die erforderlichen Anfrageparameter ein, z. B. customerId, 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 jedoch weiterhin einen Wert eingeben, wenn Sie im Formular dazu aufgefordert werden.
    • Definieren Sie den Anfragetext mit dem interaktiven JSON-Editor, wenn die Methode eine Nutzlast erfordert, 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.
  • JSON-Nutzlastformatierung: Erstellen Sie interaktiv komplexe JSON-Objekte für Anfragen. 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.
  • Fehlerprüfung: Sie können sich detaillierte Fehlermeldungen und Codes (z. B. QUERY_ERROR oder AUTHENTICATION_ERROR) in der Rohantwort ansehen, um das Debugging zu beschleunigen.
  • Codeexport: Exportieren Sie curl-Befehle, unbearbeitete HTTP-Anfragen oder JavaScript-Beispielcode aus der maximierten Ansicht des API-Explorers.

Beispielanwendungsfälle

  • Kontoeinstellungen prüfen: Sie können Konfigurationen oder Metadaten auf Kontoebene schnell abrufen, indem Sie eine GoogleAdsService/Search-Anfrage an die Ressource customer senden.
  • Mutationen testen: Prüfen Sie, ob die Kampagnenerstellung oder Budgetaktualisierung erfolgreich war, bevor Sie den Code in der Produktion bereitstellen.
  • GAQL-Debugging: Mit dem Explorer können Sie einen Google Ads Query Language (GAQL)-String ausführen und prüfen, ob die zurückgegebene JSON-Struktur den Erwartungen Ihrer Anwendung entspricht.
  • Protokollprüfung: Prüfen Sie die genauen HTTP-Header und die JSON-Verschachtelung, die für eine bestimmte API-Version erforderlich sind.