Générateur de requêtes Google Ads

L'outil de création de requêtes Google Ads est un outil interactif conçu pour vous aider à créer et valider des requêtes à l'aide du langage de requête Google Ads (GAQL). Que vous soyez novice ou expérimenté en GAQL, le générateur de requêtes peut simplifier le processus d'extraction des données exactes dont vous avez besoin à partir de l'API Google Ads.

Avantages

  • Facilité d'utilisation : simplifie le processus d'écriture des requêtes GAQL, sans nécessiter de connaître la syntaxe spécifique ni les champs disponibles.
  • Découverte : permet d'explorer et de trouver les ressources, les champs, les segments et les métriques disponibles dans le modèle de données de l'API Google Ads.
  • Réduction des erreurs : en fournissant une interface structurée et des menus déroulants d'options valides, elle permet d'éviter les erreurs de syntaxe et de frappe, ce qui garantit la validité de la requête générée.
  • Création de requêtes plus rapide : accélère le processus de développement en automatisant la génération de chaînes de requête.
  • Validation : l'outil est associé à l'explorateur d'API et au validateur de requêtes pour vérifier les requêtes par rapport aux règles de l'API avant leur exécution.

Fonctionnement

L'outil de création de requêtes Google Ads fournit une interface conviviale permettant d'assembler visuellement des requêtes GAQL. Voici le workflow de base :

  1. Sélectionnez une ressource : commencez par choisir la ressource principale dans l'onglet Référence pour la version que vous souhaitez interroger. Cette ressource est placée dans la clause FROM. Les ressources représentent des entités dans Google Ads, telles que campaign, ad_group ou keyword_view. Le générateur liste toutes les ressources disponibles.
  2. Choisir des champs : une fois la ressource sélectionnée, l'outil affiche tous les champs sélectionnables, y compris les attributs, les segments et les métriques associés à cette ressource et à ses ressources attribuées (pouvant être jointes de manière implicite). Vous pouvez cocher des cases pour inclure des champs dans votre clause SELECT. À mesure que vous effectuez des sélections, l'outil génère de manière dynamique la chaîne de requête GAQL correspondante, affiche les éventuelles erreurs et filtre les combinaisons de champs incompatibles.
  3. Appliquer des filtres : ajoutez des conditions de clause WHERE pour filtrer les résultats. Il vous aide à choisir les champs, les opérateurs et les valeurs, en veillant à ce que la syntaxe soit correcte.
  4. Trier les résultats : spécifiez l'ordre de tri à l'aide de la clause ORDER BY.
  5. Définissez des limites : ajoutez une clause LIMIT pour contrôler le nombre de résultats renvoyés.
  6. Valider : l'outil vous guide vers des combinaisons de champs valides et vous redirige vers l'API Explorer pour que vous puissiez tester votre requête par rapport aux données de votre compte. Il existe également un outil de validation des requêtes distinct, dans lequel vous pouvez coller et vérifier les requêtes GAQL écrites manuellement.
  7. Exporter : une fois que vous êtes satisfait de votre requête, copiez et collez votre chaîne GAQL testée et syntaxiquement correcte dans vos requêtes client GoogleAdsService.Search ou SearchStream.

L'outil de création s'assure que les champs, segments et métriques sélectionnés sont compatibles et peuvent être utilisés ensemble dans une même requête, en référence aux métadonnées sous-jacentes de l'API Google Ads.

Commencer

Il existe deux façons d'accéder au générateur de requêtes : en passant par une page spécifique de la documentation de référence sur les rapports ou en explorant la page de présentation du générateur de requêtes.

À partir de la documentation de référence sur les rapports

  1. Commencez par consulter la documentation de référence sur les rapports, puis choisissez une ressource spécifique dans la liste de toutes les ressources. Vous pouvez également accéder directement à la ressource depuis le panneau de navigation de gauche.
  2. Cliquez sur M'aider à créer une requête pour accéder au générateur de requêtes de cette ressource spécifique.

Depuis la page d'aperçu du générateur de requêtes

Accédez à la section Générateur de requêtes de la documentation de référence sur les rapports et sélectionnez la ressource que vous souhaitez explorer.

Intégration à d'autres outils

Le générateur de requêtes est intégré à d'autres outils du kit de développement de l'API Google Ads. Vous pouvez prendre une requête créée dans le générateur de requêtes et la tester dans l'explorateur d'API ou la valider avec le validateur de requêtes.

API Explorer

Une fois votre requête créée, cliquez sur Essayer dans APIs Explorer pour l'ouvrir dans APIs Explorer. Votre requête est automatiquement renseignée dans le corps de la requête. Vous pouvez ensuite la tester en l'exécutant sur les données de votre compte. Pour en savoir plus sur cet outil, consultez APIs Explorer.

Outil de validation des requêtes

Lorsque vous cliquez sur Saisir ou modifier une requête, l'outil de validation des requêtes s'ouvre. Utilisez l'outil de validation des requêtes pour vérifier la syntaxe de votre requête. Toute requête entièrement créée à l'aide du Générateur de requêtes possède déjà la syntaxe correcte. Toutefois, si vous connaissez la ressource que vous interrogez, le validateur de requête vous permet de saisir rapidement une requête et de vérifier sa validité. Pour en savoir plus sur cet outil, consultez Validateur de requêtes.