Google Ads API : comment obtenir son accès (developer token, OAuth2)

Pour accéder à la Google Ads API, vous avez besoin de trois éléments : un developer token approuvé par Google, des identifiants OAuth2 via Google Cloud Console, et un compte Google Ads Manager (MCC). Le processus d’approbation prend 1 à 5 jours ouvrables. Sans developer token valide, aucun appel API n’est possible, même en environnement de test.

Prérequis avant de demander l’accès à la Google Ads API

Avant de soumettre votre demande, vérifiez que vous disposez de :

• Un compte Google Ads Manager (MCC) actif — l’API n’est pas accessible depuis un compte simple
• Un projet Google Cloud avec l’API Google Ads activée
• Un cas d’usage clair à décrire lors de la demande (agence, outil de reporting, automatisation de campagnes)

L’API Google Ads est destinée aux développeurs et agences gérant des volumes importants de comptes. Pour comprendre ce que permet l’API dans sa dernière version, consultez notre article sur les nouveautés de la Google Ads API v24.

Étape 1 — Obtenir votre developer token

Le developer token est la clé d’identification principale de votre application auprès de l’API Google Ads. Il est lié à votre compte MCC, pas à un compte client individuel.

Comment faire la demande

1. Connectez-vous à votre compte Google Ads MCC
2. Allez dans Outils → Centre API (ou Tools → API Center)
3. Remplissez le formulaire de demande : nom de l’application, cas d’usage, volume estimé d’appels
4. Soumettez la demande — Google examine manuellement chaque dossier

Niveaux d’accès du developer token

Niveau	Description	Limite d’appels
Test Account	Accès immédiat, comptes test uniquement	1 000/jour
Basic Access	Après approbation, comptes réels limités	15 000/jour
Standard Access	Accès complet après justification avancée	Illimité (quotas par service)

⚠️ En Test Account, vous pouvez développer et tester votre intégration, mais uniquement sur des comptes de test Google Ads — impossible d’accéder aux données réelles de vos clients.

Étape 2 — Configurer OAuth2 via Google Cloud Console

OAuth2 est le protocole d’authentification utilisé par la Google Ads API pour autoriser votre application à accéder aux données d’un compte. Il existe deux types de flux selon votre contexte :

Flux OAuth2 disponibles

• Web application flow : pour les applications SaaS où l’utilisateur autorise l’accès via son navigateur (refresh token longue durée)
• Service account flow : pour les scripts serveur et automatisations sans interaction humaine (recommandé pour les agences)
• Desktop/CLI flow : pour les scripts locaux et les premiers tests

Créer vos identifiants OAuth2

1. Rendez-vous sur Google Cloud Console → sélectionnez votre projet
2. Activez l’API Google Ads dans la bibliothèque d’APIs
3. Allez dans APIs & Services → Identifiants → Créer des identifiants
4. Choisissez ID client OAuth 2.0
5. Configurez l’écran de consentement OAuth (nom de l’application, email de contact)
6. Notez votre Client ID et votre Client Secret

Générer un refresh token

Le refresh token permet à votre application d’obtenir des access tokens renouvelés sans ré-authentification. Avec la bibliothèque client Python :

python generate_user_credentials.py \
  --client_id=YOUR_CLIENT_ID \
  --client_secret=YOUR_CLIENT_SECRET

Conservez ce refresh token en sécurité — il donne accès à tous les comptes autorisés.

Étape 3 — Configurer votre fichier google-ads.yaml

La plupart des bibliothèques client Google Ads utilisent un fichier de configuration centralisé. Voici la structure standard :

developer_token: VOTRE_DEVELOPER_TOKEN
client_id: VOTRE_CLIENT_ID
client_secret: VOTRE_CLIENT_SECRET
refresh_token: VOTRE_REFRESH_TOKEN
login_customer_id: VOTRE_MCC_ID  # Sans tirets
use_proto_plus: True

Le champ login_customer_id correspond à l’ID de votre compte MCC (sans les tirets). Ce paramètre est obligatoire pour accéder aux comptes clients via un MCC.

Étape 4 — Tester votre connexion

Une fois votre configuration prête, testez avec un appel simple avant de développer votre intégration complète :

from google.ads.googleads.client import GoogleAdsClient

client = GoogleAdsClient.load_from_storage("google-ads.yaml")
ga_service = client.get_service("GoogleAdsService")

query = """
  SELECT customer.id, customer.descriptive_name
  FROM customer
  LIMIT 10
"""
response = ga_service.search(customer_id="VOTRE_CLIENT_ID", query=query)
for row in response:
    print(f"ID: {row.customer.id} | Nom: {row.customer.descriptive_name}")

Si cet appel retourne vos comptes sans erreur, votre configuration est opérationnelle. Une fois l’accès obtenu, pensez à anticiper les migrations de versions et sunset dates pour maintenir votre intégration à jour.

Erreurs fréquentes lors de la configuration

DEVELOPER_TOKEN_NOT_APPROVED

Votre developer token est encore en statut Test Account et vous tentez d’accéder à un compte réel. Solution : attendez l’approbation Basic Access ou utilisez un compte de test.

OAUTH_TOKEN_INVALID

Le refresh token est expiré ou révoqué. Régénérez-le via la procédure OAuth2 et mettez à jour votre fichier de configuration.

USER_PERMISSION_DENIED

L’utilisateur dont le refresh token est utilisé n’a pas accès au compte client demandé. Vérifiez les autorisations dans Google Ads MCC.

Bonnes pratiques de sécurité

• Ne jamais committer le fichier google-ads.yaml dans un dépôt Git public
• Utiliser des variables d’environnement pour les secrets en production
• Activer la rotation automatique des tokens OAuth2
• Restreindre les scopes OAuth2 au minimum nécessaire
• Monitorer les quotas d’appels API depuis Google Cloud Console

FAQ — Accès à la Google Ads API

Combien de temps prend l’approbation d’un developer token ?

L’approbation du niveau Basic Access prend généralement 1 à 5 jours ouvrables. Google examine manuellement chaque demande. Préparez une description claire de votre cas d’usage (type d’application, volume estimé, comptes gérés).

Faut-il un compte MCC pour utiliser la Google Ads API ?

Oui, le developer token est systématiquement lié à un compte Google Ads Manager (MCC). Il est impossible d’obtenir un token depuis un compte simple. Si vous êtes une agence, votre MCC existant suffit.

La Google Ads API est-elle payante ?

L’API en elle-même est gratuite. Vous payez uniquement les dépenses publicitaires habituelles sur les comptes gérés. Des quotas d’appels existent selon votre niveau d’accès (Basic : 15 000 opérations/jour, Standard : quotas par service).

Puis-je utiliser la Google Ads API sans développeur ?

Non. L’API nécessite des compétences de développement (Python, Java, PHP, etc.) pour l’intégration. Si vous recherchez de l’automatisation sans code, des outils comme Google Ads Scripts ou des plateformes tierces sont plus adaptés à votre besoin.

Voir aussi : Importer des conversions offline via la Google Ads API pour valoriser vos leads CRM dans Smart Bidding.

Article rédigé par l’équipe AdSim, agence de marketing digital à Liège. Mise à jour : mai 2026.