En 2014, nous avions publié AWQL.me, une console gratuite pour exécuter des requêtes AWQL (AdWords Query Language) et voir le résultat dans un tableau. AWQL a disparu avec l’API AdWords, arrêtée en avril 2022. Son successeur s’appelle GAQL, Google Ads Query Language : c’est lui qu’on utilise aujourd’hui dans l’API Google Ads, dans les scripts Google Ads et dans la plupart des connecteurs de reporting.
GAQL en bref
GAQL ressemble toujours à du SQL, mais on n’interroge plus des « rapports » : on interroge des ressources (campaign, ad_group, keyword_view, search_term_view…), et les champs sont préfixés par leur famille (campaign., metrics., segments.).
La requête d’exemple de la version 2014 de cet article, en AWQL :
SELECT CampaignId, CampaignName, Clicks, Impressions
FROM CAMPAIGN_PERFORMANCE_REPORT
WHERE Impressions < 100
DURING 20131001,20131031
devient en GAQL :
SELECT campaign.id, campaign.name, metrics.clicks, metrics.impressions
FROM campaign
WHERE metrics.impressions < 100
AND segments.date BETWEEN '2026-10-01' AND '2026-10-31'
ORDER BY metrics.impressions DESC
Les différences qui piègent le plus souvent :
- La période se filtre sur
segments.date, avecBETWEENou une période prédéfinie :segments.date DURING LAST_30_DAYS. - Pas de
JOINni deGROUP BY: les métriques sont agrégées selon les champs sélectionnés. Ajoutersegments.dateauSELECTdonne une ligne par jour. - Tous les champs ne sont pas compatibles entre eux : certains segments ne peuvent pas être sélectionnés avec certaines ressources ou métriques.
ORDER BYetLIMITfonctionnent sur toutes les ressources, alors que les rapports AWQL ne les acceptaient pas.
Trois façons de tester une requête
1. Le générateur de requêtes de Google
La documentation de l’API Google Ads propose un générateur interactif : on choisit la ressource, on coche les champs, et il n’affiche que les combinaisons compatibles. Un validateur vérifie aussi la syntaxe d’une requête écrite à la main. C’est le moyen le plus rapide de savoir si un champ existe et s’il peut être combiné avec les autres. Point de départ : la présentation du langage GAQL dans la documentation Google.
2. Un script Google Ads en mode aperçu
Pour voir les vraies données d’un compte sans rien installer, un script de quelques lignes suffit. Dans Google Ads, Outils › Actions groupées › Scripts, créez un script, collez ce code et cliquez sur Aperçu : la requête s’exécute et le résultat s’affiche dans les journaux, sans rien modifier dans le compte.
function main() {
const requete = `
SELECT campaign.name, metrics.clicks, metrics.impressions, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.clicks DESC
LIMIT 20`;
const lignes = AdsApp.search(requete);
while (lignes.hasNext()) {
const ligne = lignes.next();
const cout = ligne.metrics.costMicros / 1e6; // les montants sont en millionièmes
Logger.log(`${ligne.campaign.name} : ${ligne.metrics.clicks} clics, ${cout.toFixed(2)} €`);
}
}
Deux détails : dans le résultat, les noms de champs passent en camelCase (cost_micros devient costMicros), et les montants sont exprimés en micros, à diviser par un million.
3. Un export vers Google Sheets
Pour un résultat de plusieurs centaines de lignes, les journaux ne suffisent plus. La même requête peut être envoyée directement dans une feuille de calcul :
function main() {
const classeur = SpreadsheetApp.create('Test GAQL');
AdsApp.report(
'SELECT campaign.name, metrics.clicks, metrics.impressions ' +
'FROM campaign WHERE segments.date DURING LAST_MONTH'
).exportToSheet(classeur.getActiveSheet());
Logger.log('Résultat : ' + classeur.getUrl());
}
Et ensuite
Une requête au point sert ensuite de base à tout le reste : un script d’envoi mensuel du budget à vos clients, un tableau de bord, un reporting Google Ads automatisé ou une alerte quand un indicateur dérape.
Pour des requêtes qui croisent Google Ads avec vos marges, votre CRM ou vos appels, voir notre offre de scripts Google Ads et d’outils sur-mesure.