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 de manière interactive à l'aide du langage de requête Google Ads (GAQL). Que vous soyez un nouvel utilisateur ou un utilisateur expérimenté de 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 de requêtes GAQL, sans nécessiter de connaître la syntaxe spécifique ni les champs disponibles.
- Découvrabilité : vous 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 : grâce à une interface structurée et à des menus déroulants d'options valides, il permet d'éviter les erreurs de syntaxe et de frappe, et de s'assurer que la requête générée est valide.
- Création plus rapide de requêtes : 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'API Explorer et à l'outil de validation des requêtes pour vérifier les requêtes par rapport aux règles de l'API avant leur exécution.
Fonctionnement
Le générateur de requêtes Google Ads fournit une interface conviviale pour assembler visuellement des requêtes GAQL. Procédure standard :
- 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 se trouvera dans la clause
FROM. Les ressources représentent des entités dans Google Ads, telles quecampaign,ad_groupoukeyword_view. Le générateur liste toutes les ressources disponibles. - Choisissez des champs : une fois une 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 (qui peuvent être jointes implicitement). 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 dynamiquement la chaîne de requête GAQL correspondante, affiche les erreurs et filtre les combinaisons de champs incompatibles. - Appliquez des filtres : vous pouvez ajouter des conditions de clause
WHEREpour filtrer les résultats. Le générateur vous aide à choisir des champs, des opérateurs et des valeurs, en veillant à ce que la syntaxe soit correcte. - Triez les résultats : spécifiez les ordres de tri à l'aide de la clause
ORDER BY. - Définissez des limites : ajoutez une clause
LIMITpour contrôler le nombre de résultats renvoyés. - Validez : l'outil vous guide vers des combinaisons de champs valides, mais il est également associé à 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 Query Validator dans lequel vous pouvez coller et vérifier les requêtes GAQL écrites manuellement.
- Exportez : 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, les segments et les métriques sélectionnés sont compatibles et peuvent être utilisés ensemble dans une seule requête, en référençant les métadonnées sous-jacentes de l'API Google Ads.
Premiers pas
Vous pouvez accéder au générateur de requêtes de deux manières. Vous pouvez passer par une page spécifique de la documentation de référence sur les rapports ou explorer la page de présentation du générateur de requêtes.
Depuis la documentation de référence sur les rapports
- Commencez par 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 Aidez-moi à créer une requête pour accéder au générateur de requêtes de 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 avec 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'API Explorer ou la valider avec l'outil de validation des requêtes.
API Explorer
Une fois votre requête créée, cliquez sur Essayer dans API Explorer pour l'ouvrir dans l'API Explorer. Votre requête sera automatiquement renseignée dans le corps de la requête, et vous pourrez ensuite la tester en l'exécutant par rapport aux données de votre compte. Pour en savoir plus sur cet outil, consultez la page API 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 via le générateur de requêtes aura déjà la syntaxe correcte, mais si vous connaissez la ressource que vous interrogez, l'outil de validation des requêtes vous permettra de saisir rapidement une requête et de vérifier sa validité. Pour en savoir plus sur cet outil, consultez la page Outil de validation des requêtes.