Google Ads API Explorer

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

Vorteile

  • Tests ohne Code: 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: Prüfen Sie das Endpunktverhalten und untersuchen Sie die Roh-API-Antworten, bevor Sie die Logik in Ihrer Anwendung implementieren.
  • Vereinfachte Authentifizierung: Das Tool verwaltet OAuth 2.0-Abläufe 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 Referenz dokumentation 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 ein, z. B. customerId, und maximieren Sie Header, um optionale HTTP-Header wie login-customer-id anzugeben. Dieser ist nur erforderlich, wenn Sie über ein Verwaltungskonto auf ein Konto zugreifen. Beachten Sie, dass Entwicklertokens (developer-token) am 9. September 2026 eingestellt wurden und von API-Servern ignoriert werden. Sie können aber trotzdem einen Wert eingeben, wenn Sie vom 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 von 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 der JSON-Nutzlast: Erstellen Sie interaktiv komplexe JSON-Objekte für Anfragen. Das Tool hebt dabei erforderliche Felder und gültige Schemastrukturen hervor.
  • Feldmasken: Testen Sie die Logik von update_mask, um zu sehen, wie sich partielle Ressourcenaktualisierungen in der Praxis verhalten.
  • Fehleruntersuchung: Sehen Sie sich detaillierte Fehlermeldungen und -codes (z. B. QUERY_ERROR oder AUTHENTICATION_ERROR) in der Rohantwort an, um die Fehlersuche zu beschleunigen.
  • Codeexport: Exportieren Sie curl-Befehle, Roh-HTTP-Anfragen oder Beispiel-JavaScript-Code aus der maximierten Ansicht des API Explorers.

Beispielanwendungsfälle

  • Kontoeinstellungen prüfen: Rufen Sie schnell Konfigurationen auf Kontoebene oder Metadaten ab, indem Sie eine GoogleAdsService/Search-Anfrage für die Ressource customer ausführen.
  • Mutationen testen: Prüfen Sie, ob die Erstellung einer Kampagne oder die Aktualisierung des Budgets erfolgreich war, bevor Sie den Code in der Produktion bereitstellen.
  • GAQL-Fehler beheben: Verwenden Sie den Explorer, um einen Google Ads Query Language (GAQL)-String auszuführen und zu prüfen, ob die zurückgegebene JSON -Struktur den Erwartungen Ihrer Anwendung entspricht.
  • Protokollprüfung: Untersuchen Sie die genauen HTTP-Header und die JSON-Verschachtelung, die für eine bestimmte API-Version erforderlich sind.