Le générateur 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 un nouvel utilisateur de GAQL ou un utilisateur expérimenté, le Générateur de requêtes peut simplifier le processus de récupération 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 connaissances de la syntaxe spécifique et des champs disponibles.
- Découvrabilité : aide à explorer et à 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, il permet d'éviter les erreurs de syntaxe et les fautes 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é à APIs Explorer et à l'outil de validation des requêtes pour vérifier les requêtes par rapport aux règles de l'API avant l'exécution.
Fonctionnement
Le générateur de requêtes Google Ads fournit une interface conviviale pour assembler visuellement des requêtes GAQL. Voici le workflow de base :
- Sélectionnez une ressource : commencez par choisir la ressource principale dans l'onglet Référence de 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 quecampaign,ad_groupoukeyword_view. Le compilateur liste toutes les ressources disponibles. - Sélectionner des champs : une fois qu'une ressource est 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 (implicitement joignables). 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 erreurs et filtre les combinaisons de champs incompatibles. - Appliquer des filtres : ajoutez des conditions de clause
WHEREpour filtrer les résultats. Le générateur vous aide à choisir les champs, les opérateurs et les valeurs, en garantissant une syntaxe correcte. - Trier les résultats : spécifiez les ordres de tri à l'aide de la clause
ORDER BY. - Définir des limites : ajoutez une clause
LIMITpour contrôler le nombre de résultats renvoyés. - Validation : l'outil vous guide naturellement vers des combinaisons de champs valides et fournit également un lien vers APIs Explorer pour que vous puissiez tester votre requête sur les 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.
- 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.SearchouSearchStream.
Le générateur 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érençant les 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 : via une page spécifique de la documentation de référence sur les rapports ou via la page de présentation du générateur de requêtes.
Dans la documentation de référence sur les rapports
- 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 volet de navigation de gauche.
- Cliquez sur M'aider à créer une requête, ce qui vous redirige vers le générateur de requêtes pour cette ressource spécifique.
Depuis la page de présentation 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, puis 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 tester une requête créée dans le générateur de requêtes dans l'explorateur d'API ou la valider avec l'outil de validation des requêtes.
API Explorer
Une fois que vous avez créé votre requête, 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 valider la syntaxe de votre requête. Toute requête créée entièrement à l'aide du générateur de requêtes possède déjà la syntaxe appropriée. Toutefois, si vous connaissez la ressource que vous interrogez, l'outil de validation des requêtes vous permet de saisir rapidement une requête et de vérifier sa validité. Pour en savoir plus sur cet outil, consultez Outil de validation des requêtes.