Validateur de requêtes Google Ads

L'outil de validation de requêtes Google Ads est un outil interactif conçu pour aider les développeurs à créer et à vérifier des requêtes en 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 dès le début, avant qu'elles ne soient intégrées dans des 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 avoir à effectuer des cycles complets de requêtes API et de réponses.
  • Compréhension des contraintes GAQL : aide les développeurs à comprendre les règles complexes concernant les champs compatibles 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, souvent plus détaillés qu'une erreur d'API générique, et suggère parfois des alternatives valides.
  • Efficacité des ressources : évite les appels d'API inutiles avec des requêtes qui sont vouées à l'échec.

Fonctionnement

L'outil de validation 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 une grande partie est accessible à partir de GoogleAdsFieldService, pour effectuer des vérifications, y compris les suivantes :

  1. Syntaxe et structure : s'assure que la requête suit la grammaire GAQL correcte, y compris l'utilisation et l'ordre appropriés 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 orthographiés correctement.
  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 : s'assure que les segments et les métriques utilisés ensemble dans la même requête sont compatibles entre eux et avec la ressource de la clause FROM.
  5. Exigences des 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 l'utilisation correcte des opérateurs 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, et propose parfois des suggestions de corrections, telles que des ressources compatibles pour une métrique donnée.

Premiers pas

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

  1. Accédez à l' outil de validation de requêtes.
  2. Saisissez votre requête GAQL.
  3. Cliquez sur le bouton Valider la requête.
  4. Consultez le message de validation qui s'affiche sous le widget de l'outil de validation de requêtes. Un message de confirmation indique que la requête est valide. Sinon, un message d'erreur décrivant le problème s'affiche. Les messages d'erreur vous guident pour corriger la requête. Par exemple, une erreur d'incompatibilité de champ peut répertorier d'autres ressources *compatibles* avec la métrique ou le segment que vous essayez d'interroger.

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