L’essentiel en 30 secondes
- Les Scripts s'exécutent chez Google en JavaScript, sans infrastructure ; l'API s'appelle depuis votre propre logiciel.
- Un script est interrompu après 30 minutes (60 minutes pour un script MCC en parallèle avec rappel).
- Depuis le 9 septembre 2026, l'accès à l'API dépend du niveau d'accès du projet Google Cloud, plus du developer token.
- Scripts pour les alertes et rapports simples, API pour les intégrations et les gros volumes : les deux se combinent.
Google Ads Scripts, c'est du JavaScript exécuté par Google dans votre compte, sans serveur à gérer ; la Google Ads API, c'est une interface que votre propre logiciel appelle depuis votre infrastructure. Google résume lui-même le choix ainsi : si vous voulez écrire votre logique sans gérer de serveurs, prenez les Scripts ; si vous construisez un logiciel ou une intégration et que vous savez gérer serveurs et bases de données, prenez l'API12. Le reste de cet article détaille les limites qui font basculer d'un côté ou de l'autre.
Qu'est-ce qui distingue concrètement les deux outils ?
| Critère | Google Ads Scripts | Google Ads API |
|---|---|---|
| Langage | JavaScript, dans un éditeur intégré à Google Ads | Au choix via les bibliothèques officielles (Java, .NET, PHP, Python, Ruby, Perl) ou REST5 |
| Infrastructure | Aucune : exécution et planification par Google | La vôtre (serveur, cloud, fonction planifiée) |
| Accès | Un compte Google Ads suffit | Projet Google Cloud avec l'API activée, niveau d'accès approuvé et identifiants OAuth 2.04 |
| Durée d'exécution | 30 minutes ; jusqu'à 60 minutes pour un script de compte administrateur qui traite les comptes en parallèle avec rappel3 | Pas de limite de durée côté Google ; limites de débit et quotas quotidiens selon le niveau d'accès6 |
| Volume | 50 000 résultats par itérateur par défaut ; 50 comptes par exécution parallèle3 | De 2 880 opérations par jour sur comptes réels (accès Explorer) à illimité (accès Standard)6 |
| Coût | Gratuit | Gratuit ; l'hébergement est à votre charge |
Quand les Scripts suffisent-ils ?
Les Scripts donnent accès à la plupart des fonctionnalités de Google Ads via des appels de lecture et de modification2. Ils sont le bon choix pour :
- des alertes (budget consommé trop vite, campagne tombée à zéro impression, annonce refusée) envoyées par e-mail ;
- des rapports réguliers écrits dans Google Sheets ;
- des règles de gestion simples (mettre en pause des mots clés trop chers, ajuster un budget) ;
- des données externes lues par une URL (stock, météo, prix) ;
- un traitement sur plusieurs comptes clients depuis un compte administrateur (MCC), avec les limites ci-dessus3.
Leur principale limite est la durée : un traitement qui dépasse 30 minutes est interrompu (les modifications déjà faites sont conservées)3. Pour les gros comptes, il faut découper le travail ou passer à l'API.
Quand l'API devient-elle nécessaire ?
- Vous intégrez Google Ads à un outil maison, un CRM, un ERP ou un entrepôt de données.
- Vous gérez un grand nombre de comptes ou de modifications, au-delà des limites des Scripts.
- Vous développez un produit utilisé par d'autres entreprises, qui se connectent à leurs propres comptes.
- Vous voulez des traitements longs, versionnés et testés comme n'importe quel logiciel.
Pour de simples exports de données vers un entrepôt, Google recommande plutôt le service de transfert de données BigQuery pour Google Ads, sans code1.
Qu'est-ce qui a changé pour l'accès à l'API en 2026 ?
Depuis le 9 septembre 2026, le « developer token » n'est plus le sésame de l'API. Les niveaux d'accès (Test, Explorer, Basic, Standard) sont rattachés au projet Google Cloud qui détient vos identifiants OAuth, et l'inscription se fait dans la Google Cloud Console, sans compte administrateur Google Ads4. Le token peut encore être envoyé, mais il est ignoré ; Google prévient qu'il sera rejeté dans une future version majeure4. Le détail des démarches est dans notre guide sur les démarches d'accès à l'API.
Peut-on combiner Scripts et API ?
Oui, et c'est souvent le plus simple : l'API pour les intégrations lourdes (création de campagnes depuis un catalogue, synchronisation avec un CRM), les Scripts pour les alertes quotidiennes qui n'ont pas besoin d'infrastructure. Si vous hésitez sur l'architecture à retenir pour vos comptes, notre équipe en charge des campagnes de référencement payant peut en discuter lors d'un audit gratuit.
Sources
- Introduction to the Google Ads API (Google for Developers)
- Google Ads scripts : get started (Google for Developers)
- Google Ads scripts : limits (Google for Developers)
- Developer token sunset and API access management (Google for Developers)
- Deprecation and sunset : supported client library versions (Google for Developers)
- API limits and quotas (Google for Developers)






Commentaires
Chaque commentaire est relu avant publication, en général sous 24 h ouvrées. Les liens promotionnels ne sont pas publiés.
Aucun commentaire pour l’instant. Une question sur l’article ? Posez-la ci-dessous.