Google Ads Query Validator

Der Google Ads Query Validator ist ein interaktives Tool, mit dem Entwickler Abfragen in der Google Ads Query Language (GAQL) erstellen und prüfen können, bevor sie sie in Anwendungen einbinden. Sie können einen GAQL-Abfragestring eingeben und erhalten sofort Feedback zu seiner Gültigkeit. So lassen sich Syntaxfehler, Feldinkompatibilitäten und andere Probleme frühzeitig im Entwicklungsprozess erkennen.

Vorteile

  • Fehlervermeidung: Ungültige Abfragen werden frühzeitig erkannt, bevor sie in Anwendungen eingebunden werden. Dadurch werden Laufzeitfehler und Fehler bei API-Aufrufen reduziert.
  • Schnellere Entwicklung: Ermöglicht schnelles Testen und Debuggen von GAQL-Anweisungen ohne den Aufwand vollständiger API-Anfrage- und Antwortzyklen.
  • GAQL-Einschränkungen verstehen: Hier erfahren Entwickler mehr über die komplexen Regeln, die festlegen, welche Felder kompatibel sind und wie Ressourcen miteinander in Beziehung stehen.
  • Abfragen debuggen: Es werden spezifische Fehlermeldungen ausgegeben, wenn eine Abfrage ungültig ist. Diese sind oft detaillierter als ein allgemeiner API-Fehler und manchmal werden gültige Alternativen vorgeschlagen.
  • Ressourceneffizienz: Unnötige API-Aufrufe mit Abfragen, die fehlschlagen, werden vermieden.

Funktionsweise

Die Abfragevalidierung analysiert Ihre GAQL-Abfrage anhand des Schemas der Google Ads API und der in der Google Ads Query Language definierten Regeln. Es verwendet Metadaten, von denen viele über GoogleAdsFieldService zugänglich sind, um Prüfungen durchzuführen, darunter:

  1. Syntax und Struktur: Es wird geprüft, ob die Abfrage der richtigen GAQL-Grammatik entspricht, einschließlich der korrekten Verwendung und Reihenfolge von Klauseln wie SELECT, FROM, WHERE, ORDER BY, LIMIT und PARAMETERS.
  2. Feldgültigkeit: Es wird geprüft, ob alle angegebenen Felder (Ressourcen, Segmente, Messwerte) vorhanden und richtig geschrieben sind.
  3. Ressourcenkompatibilität: Es wird geprüft, ob die in der SELECT-Klausel ausgewählten Felder mit der in der FROM-Klausel angegebenen primären Ressource kompatibel sind.
  4. Kompatibilität von Segmenten und Messwerten: Es wird sichergestellt, dass die Segmente und Messwerte, die in derselben Abfrage verwendet werden, miteinander und mit der Ressource in der FROM-Klausel kompatibel sind.
  5. Klauselanforderungen: Es werden Regeln wie die Anforderung validiert, dass Felder, die in ORDER BY-Klauseln verwendet werden, und bestimmte Felder, die in WHERE-Klauseln verwendet werden (z. B. Segmente), auch in der SELECT-Klausel vorhanden sein müssen.
  6. Operatorverwendung: Prüft, ob Operatoren in den Bedingungen der WHERE-Klausel korrekt verwendet werden.

Wenn die Abfrage gültig ist, wird sie vom Tool bestätigt. Wenn Probleme gefunden werden, werden Fehlermeldungen angezeigt, die Ihnen helfen, das Problem einzugrenzen. Manchmal werden auch Vorschläge für Korrekturen gemacht, z. B. kompatible Ressourcen für einen bestimmten Messwert.

Jetzt starten

So verwenden Sie die Google Ads-Abfragevalidierung:

  1. Rufen Sie die Abfragevalidierung auf.
  2. Geben Sie Ihre GAQL-Abfrage ein.
  3. Klicken Sie auf den Button Abfrage validieren.
  4. Sehen Sie sich die Validierungsmeldung an, die unter dem Widget „Abfragevalidierung“ angezeigt wird. Eine Erfolgsmeldung zeigt an, dass die Abfrage gültig ist. Andernfalls wird eine Fehlermeldung angezeigt, die das Problem beschreibt. Die Fehlermeldungen helfen Ihnen, die Abfrage zu korrigieren. Bei einem Fehler aufgrund von Feldinkompatibilität werden beispielsweise alternative Ressourcen aufgeführt, die mit dem Messwert oder Segment kompatibel sind, das Sie abfragen möchten.

Ausführlichere Erläuterungen zu GAQL-Konzepten und zur Syntax finden Sie im Leitfaden zur Google Ads Query Language. Wenn Sie GAQL-Abfragen interaktiv erstellen und testen möchten, können Sie auch den Query Builder und den API Explorer verwenden.