Validateur de requêtes Google Ads

L'outil de validation des requêtes Google Ads est un outil interactif conçu pour aider les développeurs à créer et à vérifier les requêtes du langage de requête Google Ads (GAQL) avant de les intégrer dans des applications. Il vous permet de saisir une chaîne de requête GAQL et de recevoir immédiatement des commentaires sur sa validité. Vous pouvez ainsi détecter les erreurs de syntaxe, les incompatibilités de champs et d'autres problèmes dès le début du processus de développement.

Avantages

  • Prévention des erreurs : détecte les requêtes non valides de manière précoce, avant qu'elles ne soient intégrées aux applications, ce qui réduit les erreurs d'exécution et les échecs d'appels d'API.
  • Développement plus rapide : permet de tester et de déboguer rapidement les instructions GAQL sans les frais généraux des cycles complets de requêtes et de réponses de l'API.
  • Comprendre les contraintes GAQL : aide les développeurs à comprendre les règles complexes concernant la compatibilité des champs et la relation entre les ressources.
  • Débogage des requêtes : fournit des messages d'erreur spécifiques lorsqu'une requête n'est pas valide. Ces messages sont souvent plus détaillés qu'une erreur d'API générique et suggèrent parfois des alternatives valides.
  • Efficacité des ressources : évite les appels d'API inutiles avec des requêtes qui sont vouées à l'échec.

Fonctionnement

Le validateur de requêtes analyse votre requête GAQL par rapport au schéma de l'API Google Ads et aux règles définies dans le langage de requête Google Ads. Il utilise des métadonnées, dont la plupart sont accessibles depuis GoogleAdsFieldService, pour effectuer des vérifications, y compris :

  1. Syntaxe et structure : s'assure que la requête respecte la grammaire GAQL, y compris l'utilisation et l'ordre corrects des clauses telles que SELECT, FROM, WHERE, ORDER BY et LIMIT.
  2. Validité des champs : vérifie si tous les champs spécifiés (ressources, segments, métriques) existent et sont correctement orthographiés.
  3. Compatibilité des ressources : vérifie que les champs sélectionnés dans la clause SELECT sont compatibles avec la ressource principale spécifiée dans la clause FROM.
  4. Compatibilité des segments et des métriques : permet de s'assurer que les segments et les métriques utilisés ensemble dans la même requête sont compatibles entre eux et avec la ressource dans la clause FROM.
  5. Exigences relatives aux clauses : valide les règles telles que l'exigence que certains champs utilisés dans les clauses WHERE ou ORDER BY soient également présents dans la clause SELECT.
  6. Utilisation des opérateurs : vérifie que les opérateurs sont correctement utilisés dans les conditions de la clause WHERE.

Si la requête est valide, l'outil le confirme. Si des problèmes sont détectés, il fournit des messages d'erreur conçus pour vous aider à identifier le problème, en vous proposant parfois des suggestions de solutions, comme des ressources compatibles pour une métrique donnée.

Premiers pas

Pour utiliser l'outil de validation des requêtes Google Ads :

  1. Accédez au validateur de requêtes.
  2. Saisissez votre requête GAQL.
  3. Cliquez sur le bouton Valider la requête.
  4. Examinez le message de validation qui s'affiche sous le widget "Validateur de requête". Un message de réussite indique que la requête est valide. Sinon, un message d'erreur décrivant le problème s'affiche. Les messages d'erreur vous aident à corriger la requête. Par exemple, une erreur d'incompatibilité de champ peut lister des ressources alternatives qui *sont* compatibles avec la métrique ou le segment que vous essayez d'interroger.

Pour des explications plus détaillées sur les concepts et la validation GAQL, vous pouvez également consulter les guides vidéo GAQL.