Avant de déployer une intégration Google Ads API en production, une question s’impose : quels sont les quotas, les limites et les coûts réels ? L’API Google Ads est gratuite à l’usage, mais elle impose des contraintes techniques précises que tout développeur et responsable marketing doit maîtriser pour éviter les blocages et les erreurs 429.
L’API Google Ads est-elle gratuite ?
Oui, l’API Google Ads est gratuite. Google ne facture pas l’accès à l’API ni les appels. En revanche, deux conditions s’appliquent :
- Vous devez disposer d’un developer token approuvé (niveau Basic ou Standard)
- Vous devez respecter les quotas d’utilisation définis par niveau d’accès
Les niveaux d’accès et leurs quotas
Niveau Test (non approuvé)
- Environnement : comptes test uniquement
- Quota journalier : 15 000 opérations/jour
- Usage : développement et tests unitaires
Niveau Basic (accès approuvé standard)
- Quota journalier : 15 000 opérations/jour par défaut
- Accès : comptes de production
- Usage : intégrations internes, agences gérant moins de 50 comptes
Niveau Standard (quota élevé)
- Quota journalier : jusqu’à 1 000 000 opérations/jour
- Accès : toutes fonctionnalités API
- Usage : plateformes SaaS, agences gérant des centaines de comptes
Comprendre les « opérations » dans le quota
| Type d’appel | Opérations comptées |
|---|---|
| Lecture (GAQL query) | 1 opération par requête |
| Création d’une entité | 1 opération par entité créée |
| Modification en batch | 1 opération par élément dans le batch |
| Upload de conversion offline | 1 opération par conversion |
Les limites de taille des requêtes
| Paramètre | Limite |
|---|---|
| Mutations par requête MutateXxx | 10 000 maximum |
| Éléments par batch (BatchJobService) | 200 000 opérations |
| Résultats par page (pagination) | 10 000 lignes max |
| Taille du corps de requête (gRPC) | 64 MB |
| Durée max d’un job asynchrone | 24 heures |
Gestion des erreurs de quota : le code 429
import time, random
from googleads.errors import GoogleAdsException
def call_with_retry(func, max_retries=5):
for attempt in range(max_retries):
try:
return func()
except GoogleAdsException as ex:
for error in ex.failure.errors:
if error.error_code.quota_error:
wait = (2 ** attempt) + random.uniform(0, 1)
time.sleep(wait)
raiseLimites spécifiques par service
ConversionUploadService
- Maximum 2 000 conversions par appel
- Fenêtre d’attribution : jusqu’à 90 jours après le clic
- Délai minimum avant upload : 6 heures après le clic
ReportingService (GAQL)
- Pas de limite sur le nombre de rapports journaliers
- Fenêtre de données historiques : 3 ans
- Rafraîchissement des données : 3 heures de délai typique
Comment demander une augmentation de quota
- Accédez à la Google Ads API Center dans votre compte MCC
- Remplissez le formulaire de demande d’accès Standard
- Justifiez votre besoin : nombre de comptes gérés, volume de campagnes
- Attendez la validation Google (3 à 5 jours ouvrés)
FAQ — Quotas et limites Google Ads API
Le quota se renouvelle-t-il chaque jour ?
Oui, le quota journalier se renouvelle à minuit (heure du Pacifique, UTC-8).
Que se passe-t-il si je dépasse le quota ?
L’API retourne une erreur QUOTA_ERROR et bloque les requêtes suivantes jusqu’au renouvellement. Les opérations déjà traitées ne sont pas annulées.
Pour maîtriser l’ensemble de l’écosystème, consultez notre guide complet Google Ads API v24. Pour bien démarrer votre intégration, découvrez comment obtenir votre developer token et configurer OAuth2. Si vous souhaitez construire des rapports automatisés, consultez notre guide sur l’automatisation des rapports Google Ads via l’API. Et si vous débutez en Python, notre tutoriel Google Ads API avec Python est fait pour vous.
