API Google Ads, scripts ou interface : choisir comment automatiser

En bref

Pour automatiser Google Ads, commencez par lister les tâches que vous refaites chaque semaine. Les rapports programmés et les scripts couvrent de nombreux besoins. Une application fondée sur l’API se justifie si ces outils ne répondent pas à vos contraintes.

Certaines tâches réalisées dans Google Ads peuvent être automatisées avec les fonctions de l’interface, des scripts ou l’API. Aucun ne remplace le suivi des conversions, qui indique à Google Ads vos ventes et vos demandes de contact. Posez les fondamentaux du suivi des conversions Google Ads avant d’automatiser.

API Google Ads
L’interface de programmation officielle de Google Ads, qui a succédé à l’ancienne API AdWords. Elle permet à un logiciel autorisé de lire et de modifier vos campagnes sans passer par l’interface.

API, scripts ou rapports : que choisir ?

Listez d’abord ce que vous refaites chaque semaine

Le bon critère n’est pas la taille du compte, mais la liste des tâches que vous refaites à la main chaque semaine, à l’identique. En voici quelques exemples courants.

Chaque tâche de cette liste peut être automatisée : choisissez pour chacune le niveau le plus simple qui la couvre. L’API permet aussi d’intégrer Google Ads à vos logiciels. Le besoin doit justifier le développement et son entretien.

Trois niveaux, du plus simple au plus lourd

Pour envoyer vos ventes à Google Ads, le chemin est différent, avec ses propres identifiants et contrôles : l’envoi des conversions par API se prépare à part ; le guide sur l’import des conversions hors ligne en détaille les contrôles.

Par défaut, restez-en aux scripts et passez à l’API quand vous constatez une limite précise, du type « le script ne peut pas faire X », et non par ambition. Demandez au prestataire quelle contrainte justifie le développement proposé. Un prototype de script n’est pas nécessaire si sa limite est déjà connue.

Quand les scripts ne suffisent plus

Les scripts ont des plafonds précis, détaillés dans la documentation officielle des limites. Un compte accepte au plus 250 scripts autorisés, et chaque exécution s’arrête au bout de 30 minutes.

Depuis un compte administrateur, un script peut aller jusqu’à 60 minutes. Il doit pour cela traiter en parallèle les comptes qu’il gère avec executeInParallel et une fonction de rappel.

Certains éléments du compte peuvent aussi être moins accessibles par script que par l’API. Un script sait appeler un service extérieur. Mais pour un échange régulier dans les deux sens avec un CRM, un logiciel de gestion ou un entrepôt de données, une application dédiée reste plus solide.

Obtenir l’accès à l’API depuis septembre 2026

Les règles d’accès ont changé le 9 septembre 2026. Google a supprimé le jeton développeur qui identifiait votre application auprès de l’API. Les droits sont désormais rattachés au projet Google Cloud qui détient vos identifiants de connexion, sur la plateforme où votre développeur déclare son application.

Les étapes de la demande

La demande se fait dans la console Google Cloud, sans compte administrateur Google Ads, sauf si l’application doit gérer plusieurs comptes. Le Centre d’API de Google Ads ne traite plus les demandes et garde seulement l’historique.

  1. Activer l’API. Dans un projet Google Cloud, activez l’API Google Ads : le projet reçoit l’accès Test, limité aux comptes de test qui ne diffusent aucune annonce.
  2. Demander l’accès Explorateur. La demande part de la page de présentation de l’API Google Ads dans la console. Google peut l’accorder automatiquement, et vous accédez alors à vos vrais comptes dans la limite de 2 880 opérations par jour.
  3. Faire vérifier votre marque. La vérification de la marque du projet Google Cloud est obligatoire avant toute demande d’accès de base.
  4. Demander l’accès de base. L’examen est automatisé et prend quelques minutes une fois la marque vérifiée. Ce niveau autorise 15 000 opérations par jour, tous comptes confondus.
  5. Demander l’accès standard si le volume l’exige. Il faut déjà l’accès de base, puis passer un audit manuel détaillé, annoncé en 10 jours ouvrés. Ce niveau lève la limite quotidienne.

Ce que chaque niveau d’accès permet

Les niveaux d’accès documentés par Google comptent les opérations sur 24 heures glissantes. L’accès Test, accordé dès l’activation, reste limité à 15 000 opérations par jour sur les comptes de test. L’accès Explorateur suffit pour démarrer sur vos vrais comptes, mais il bloque les fonctions suivantes.

Le bon niveau dépend donc des fonctions dont vous avez besoin, pas seulement du nombre de comptes. L’accès standard vise les gros volumes des grandes entreprises ou des outils utilisés par beaucoup de personnes. Même à ce niveau, chaque service garde ses propres limites de débit.

Extraire les données avec le langage GAQL

Un langage de requête propre à Google Ads

Le GAQL (Google Ads Query Language) est le langage qui sert à demander des données à l’API. Il ressemble au SQL des bases de données. Mais Google fixe lui-même la liste des éléments interrogeables, comme les campagnes et les annonces, et une donnée absente de cette liste ne s’extrait pas.

L’outil officiel Interactive Query Builder aide à construire une requête et à vérifier sa validité. Son exécution sur vos données passe ensuite par l’API. C’est le bon point de départ avant tout développement.

Search ou SearchStream pour les gros volumes

Deux méthodes officielles exécutent une requête GAQL. Search renvoie les résultats par pages de 10 000 lignes, tandis que SearchStream les envoie en un flux continu, sans pages à gérer. Pour remplir un entrepôt de données avec de gros volumes, SearchStream est souvent la méthode la plus simple.

Quel langage de programmation choisir ?

Google publie des bibliothèques officielles pour six langages : Python, Java, PHP, Ruby, .NET et Perl. Des bibliothèques maintenues par la communauté existent pour Node.js et Go, sans support de Google.

Ces bibliothèques gèrent pour vous la connexion, le format des échanges et le découpage en pages de Search. Selon la bibliothèque, elles permettent aussi de régler la relance automatique d’une demande après une erreur.

Choisissez le langage que votre équipe maîtrise déjà. Python offre beaucoup d’exemples, mais rien ne l’impose. La version de la bibliothèque doit aussi correspondre à celle de l’API, car une bibliothèque trop ancienne peut ignorer les nouveautés.

Relier Google Ads à un entrepôt de données

Un montage courant enchaîne Google Ads, un entrepôt de données comme BigQuery, puis un outil de tableaux de bord comme Data Studio (anciennement Looker Studio) ou Power BI. SearchStream en extrait les chiffres de diffusion, de coût et de conversion. Le coût, la fraîcheur des données et l’entretien dépendent du volume et du montage choisi.

L’export de GA4 vers BigQuery peut compléter ce montage. GA4 apporte les visites et les actions sur le site, alors que l’API fournit les dépenses et les résultats des annonces. Le rapprochement n’est fiable que si les deux sources partagent les mêmes définitions, les mêmes clés et les mêmes périodes.

Un entrepôt de données ne justifie pas à lui seul l’accès standard. Passez-y seulement si votre volume prévu dépasse les 15 000 opérations quotidiennes de l’accès de base, ou si votre outil sert beaucoup d’utilisateurs.

Vérifier la mesure avant d’automatiser

Une automatisation exécute sa consigne, même quand elle est fausse. Une alerte mal réglée se déclenche chaque matin, jusqu’au jour où plus personne ne la lit. Un rapport automatique fondé sur un suivi défaillant transmet des chiffres faux à tous ses destinataires.

La fiabilité des rapports automatiques dépend de celle des données de départ. Avant d’automatiser, assurez-vous des points suivants.

Commencer par automatiser une tâche précise

Cette semaine, faites la liste de vos tâches répétées, avec en face de chacune le niveau le plus simple qui la couvre. Vous pouvez commencer par une alerte de chute inhabituelle des conversions, adaptée à leur volume et à leur délai de remontée. Une journée sans conversion ne signale pas forcément une panne. Vous passerez à l’API le jour où un script bute sur une limite constatée.

Sources officielles

Questions fréquentes

Faut-il un développeur pour utiliser l’API Google Ads ?
Pour définir le besoin, non : la liste de vos tâches répétées suffit. Pour créer votre propre application, il faut des compétences de développement. Un outil existant peut déjà utiliser l’API pour vous. Les scripts s’exécutent dans Google Ads, mais leur adaptation demande aussi de comprendre le code.
Mon ancien jeton développeur fonctionne-t-il encore ?
Le code continue de fonctionner si son projet Cloud a reçu les droits nécessaires. Google a transféré les niveaux d’accès vers les projets ayant utilisé le jeton dans les 90 derniers jours. Sinon, demandez l’accès pour le projet. Le jeton envoyé avec les appels est désormais ignoré, et une prochaine version majeure de l’API le refusera : mettez vos bibliothèques à jour.
L’API Google Ads reçoit-elle encore les ventes conclues hors ligne ?
Seulement pour les accès historiques encore autorisés. Depuis le 15 juin 2026, les intégrations sans cet accès doivent utiliser l’API Data Manager pour les imports de conversions hors ligne et le suivi avancé des conversions pour les prospects.
Que se passe-t-il quand un script dépasse sa durée maximale ?
Google l’arrête en cours de route. Les modifications déjà faites restent appliquées, ce qui peut laisser le compte à moitié modifié. Le plus sûr est de découper le travail en lots, avec une reprise prévue et une vérification finale que tout a été traité.
Vincent Duquesne, consultant Google Ads
Vincent Duquesne
Expert Google Ads Certifié depuis 2011 : j’ai audité et restructuré des centaines de comptes dans des dizaines de thématiques différentes. +20M€ gérés.
Google Partner Premier 2026

Vous avez besoin d’un partenaire Google Ads ?

Je vous accompagne dans la mise en place, le suivi et l’optimisation de vos campagnes Google Ads.

Réserver un appel