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. 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 API-Rohantworten sofort, 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 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 auf der rechten Seite der Seite nach dem Feld „Ausprobieren“.
  3. Anfrage konfigurieren:
    • Geben Sie die erforderlichen Anfrageparameter ein, z. B. developer-token und login-customer-id.
    • 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 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 eine update_mask-Logik, 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, HTTP-Rohanfragen oder JavaScript-Beispielcode aus der erweiterten Ansicht des API Explorers.

Beispielanwendungsfälle

  • Kontoeinstellungen prüfen: Rufen Sie schnell Konfigurationen oder Metadaten auf Kontoebene ab, indem Sie eine get- oder search-Anfrage ausführen.
  • Mutationen testen: Prüfen Sie, ob die Erstellung einer Kampagne oder die Aktualisierung eines Budgets erfolgreich war, bevor Sie den Code in der Produktion bereitstellen.
  • GAQL-Fehler beheben: Verwenden Sie den Explorer, um einen Google Ads Query Language-String (GAQL) 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.