Google Ads Query Validator

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

Vorteile

  • Fehlervermeidung:Ungültige Anfragen werden frühzeitig erkannt, bevor sie in Anwendungen integriert werden. So werden Laufzeitfehler und fehlgeschlagene API-Aufrufe 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 dazu, welche Felder kompatibel sind und wie Ressourcen zueinander in Beziehung stehen.
  • Fehlerbehebung bei Anfragen:Wenn eine Anfrage ungültig ist, werden spezifische Fehlermeldungen angezeigt, die oft detaillierter sind als ein allgemeiner API-Fehler. Manchmal werden auch gültige Alternativen vorgeschlagen.
  • Ressourceneffizienz:Unnötige API-Aufrufe mit Anfragen, die ohnehin fehlschlagen, werden vermieden.

Funktionsweise

Der Query Validator analysiert Ihre GAQL-Abfrage anhand des Schemas der Google Ads API und der in der Google Ads Query Language definierten Regeln. Dabei werden Metadaten verwendet, von denen viele über GoogleAdsFieldService zugänglich sind. Es werden unter anderem folgende Prüfungen durchgeführt:

  1. Syntax und Struktur:Die Abfrage muss der korrekten GAQL-Grammatik entsprechen, einschließlich der richtigen Verwendung und Reihenfolge von Klauseln wie SELECT, FROM, WHERE, ORDER BY, LIMIT und PARAMETERS.
  2. Feldgültigkeit:Prüft, ob alle angegebenen Felder (Ressourcen, Segmente, Messwerte) vorhanden und richtig geschrieben sind.
  3. Ressourcenkompatibilität:Prüft, ob die in der SELECT-Klausel ausgewählten Felder mit der in der FROM-Klausel angegebenen primären Ressource kompatibel sind.
  4. Segment- und Messwertkompatibilität:Damit 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:Hier 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. Verwendung von Operatoren:Prüft, ob Operatoren in den Bedingungen der WHERE-Klausel richtig verwendet werden.

Wenn die Anfrage gültig ist, wird sie vom Tool bestätigt. Wenn Probleme gefunden werden, werden Fehlermeldungen angezeigt, die helfen, das Problem zu identifizieren. Manchmal werden auch Vorschläge zur Behebung gemacht, z. B. kompatible Ressourcen für eine bestimmte Messwert.

Jetzt starten

So verwenden Sie den Google Ads-Abfragevalidator:

  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 weist darauf hin, dass die Abfrage gültig ist. Andernfalls wird eine Fehlermeldung mit einer Beschreibung des Problems angezeigt. Die Fehlermeldungen helfen Ihnen, die Abfrage zu korrigieren. Bei einem Fehler aufgrund von Feldinkompatibilität werden möglicherweise alternative Ressourcen aufgeführt, die mit dem Messwert oder Segment kompatibel sind, den Sie abfragen möchten.

Ausführlichere Erläuterungen zu GAQL-Konzepten und zur Validierung finden Sie in den GAQL-Videoanleitungen. Sie können auch den Query Builder und den API Explorer verwenden.