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 (Lese- und Schreibvorgänge) direkt aus der Dokumentation aus, ohne eine lokale Entwicklungsumgebung einzurichten.
  • 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 sofort prüfen, 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.

Erste Schritte

  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 auf der rechten Seite der Seite nach dem Feld „Try it!“ (Ausprobieren).
  3. Anfrage konfigurieren:
    • Geben Sie die erforderlichen Anfrageparameter wie developer-token und login-customer-id ein.
    • Definieren Sie den Anfragetext mit dem interaktiven JSON-Editor, wenn für die Methode eine Nutzlast erforderlich ist, z. B. für `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 der JSON-Nutzlast:Komplexe JSON-Objekte für Anfragen lassen sich interaktiv erstellen. Das Tool hebt erforderliche Felder und gültige Schemastrukturen hervor.
  • Feldmasken:Testen Sie eine update_mask-Logik, um zu sehen, wie sich partielle Ressourcenaktualisierungen in der Praxis verhalten.
  • Fehlerprüfung:Detaillierte Fehlermeldungen und ‑codes (z. B. QUERY_ERROR oder AUTHENTICATION_ERROR) in der Rohantwort ansehen, um das Debugging zu beschleunigen.
  • 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 einem get- oder search-Aufruf lassen sich schnell Konfigurationen oder Metadaten auf Kontoebene abrufen.
  • Mutationen testen:Prüfen Sie, ob die Kampagnenerstellung oder Budgetaktualisierung erfolgreich war, bevor Sie den Code in der Produktion bereitstellen.
  • GAQL-Fehlerbehebung:Mit dem Explorer können Sie einen GAQL-String (Google Ads Query Language) 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.