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, avec BETWEEN ou une période prédéfinie : segments.date DURING LAST_30_DAYS.
  • Pas de JOIN ni de GROUP BY : les métriques sont agrégées selon les champs sélectionnés. Ajouter segments.date au SELECT donne 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 BY et LIMIT fonctionnent 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.