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 à valider 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 des commentaires immédiats sur sa validité, ce qui vous aide à détecter les erreurs de syntaxe, les incompatibilités de champs et d'autres problèmes au début du processus de développement.

Avantages

  • Prévention des erreurs : détecte les requêtes non valides de manière anticipée, 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 la surcharge des cycles complets de requête et de réponse de l'API.
  • Comprendre les contraintes GAQL : aide les développeurs à comprendre les règles complexes concernant les champs compatibles et les relations 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 vouées à l'échec.

Fonctionnement

L'outil de validation des 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 : vérifie que la requête respecte la grammaire GAQL appropriée, y compris l'utilisation et l'ordre corrects des clauses telles que SELECT, FROM, WHERE, ORDER BY, LIMIT et PARAMETERS.
  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 : garantit 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 concernant les clauses : valide les règles telles que l'obligation pour les champs utilisés dans les clauses ORDER BY et certains champs utilisés dans les clauses WHERE (comme les segments) d'être é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 aider à identifier le problème, et propose parfois des suggestions de correction, telles que des ressources compatibles pour une métrique donnée.

Commencer

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

  1. Accédez à l'outil de validation des 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 de l'outil de validation des 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 aident à corriger la requête. Par exemple, une erreur d'incompatibilité de champ peut lister d'autres ressources qui sont compatibles avec la métrique ou le segment que vous essayez d'interroger.

Pour en savoir plus sur les concepts et la syntaxe du langage GAQL, consultez le guide sur le langage de requête Google Ads. Pour créer et tester des requêtes GAQL de manière interactive, vous pouvez également utiliser le générateur de requêtes et l'API Explorer.