Un developer token Google Ads est la chaîne alphanumérique de 22 caractères que vous devez obtenir pour effectuer des appels vers l’API Google Ads. Si vous souhaitez extraire des données Google Ads en utilisant une approche basée sur du code — dlt, Airbyte, un script Python personnalisé — vous en avez besoin. Comprendre le fonctionnement du système de tokens, et le délai nécessaire pour obtenir une approbation, est le premier point de décision lors de la planification d’un pipeline de données Google Ads.
Ce qu’il débloque
Le developer token authentifie votre application auprès de l’API Google Ads. Sans lui, vous ne pouvez pas exécuter de requêtes GAQL, ne pouvez pas récupérer des données de performance de campagne de manière programmatique, et ne pouvez pas accéder à quoi que ce soit au-delà des exports standard de l’interface. Chaque outil d’extraction basé sur l’API qui n’utilise pas son propre token nécessite le vôtre.
Le token se trouve dans votre compte Google Ads Manager sous Outils → Centre API. Vous en faites la demande, décrivez votre cas d’usage, et attendez l’équipe de révision de Google.
Niveaux d’accès
L’approbation ne donne pas immédiatement accès à tout. Le système de tokens a quatre niveaux :
| Niveau | Accès | Limite d’opérations quotidiennes |
|---|---|---|
| Test Account | Développement uniquement — pas de données de production | N/A |
| Explorer | Accès limité en production — lecture seule, champs restreints | 15 000 |
| Basic | Accès complet en production | 15 000 |
| Standard | Accès complet en production | Illimité |
La plupart des équipes construisant des pipelines analytics ont besoin au moins du niveau Basic. Le niveau Standard est important si votre pipeline doit émettre un grand nombre d’opérations quotidiennes — reporting au niveau des mots-clés à fort volume sur un grand MCC, par exemple.
Le délai de révision annoncé pour les accès Basic et Standard est de 3 à 5 jours ouvrables. La réalité, rapportée de manière constante par les praticiens, est de semaines à mois. Planifiez cela dans votre calendrier de projet, pas comme une note en bas de page. Si vous avez besoin d’une extraction basée sur l’API à une date de livraison spécifique, démarrez le processus de demande bien avant le début du développement.
Pourquoi les candidatures sont rejetées
La révision de Google se concentre sur la conformité de votre utilisation prévue de l’API avec leurs politiques. Les raisons de rejet courantes incluent :
Descriptions de cas d’usage vagues. La candidature demande ce que vous construisez et pourquoi vous avez besoin d’un accès API. « Reporting analytics » ne passe pas la révision. « Extraction de métriques de performance de campagne vers BigQuery pour un reporting ROAS hebdomadaire sur 12 comptes clients gérés dans notre MCC » suffit.
Problèmes de site web. Google examine le site web associé à votre candidature. Un site incomplet, un lien vers une politique de confidentialité brisé, ou un site qui ne décrit pas clairement votre activité soulèveront des signaux d’alerte.
Divulgation d’outils tiers. Celui-ci surprend les équipes. L’utilisation d’outils open source comme Airbyte avec votre developer token peut violer les politiques d’API de Google. Mentionner Airbyte ou d’autres outils tiers dans votre candidature est un déclencheur courant de rejet. La politique est que les outils doivent être approuvés pour l’utilisation de l’API, et de nombreux connecteurs open source ne le sont pas. Fivetran, en revanche, utilise son propre developer token géré — vous vous authentifiez à Fivetran avec OAuth, et leur token gère l’accès à l’API. C’est l’une des raisons pour lesquelles les connecteurs gérés existent.
Type de compte inapproprié. La candidature doit provenir d’un compte Google Ads Manager (MCC). Soumettre depuis un compte ordinaire signale que vous ne comprenez pas le modèle d’accès à l’API.
Quels outils nécessitent un developer token
Voici la répartition pratique qui oriente votre approche de chargement :
| Approche | Developer token requis |
|---|---|
| BigQuery Data Transfer Service | Non |
| Google Ads Scripts | Non |
| Fivetran | Non (ils utilisent le leur) |
| dlt | Oui |
| Airbyte | Oui |
| Pipeline API personnalisé | Oui |
Si vous n’avez pas de token et devez aller vite, BigQuery Data Transfer Service, Fivetran ou Google Ads Scripts sont vos options. Si vous pouvez faire approuver un token, dlt et les pipelines personnalisés s’ouvrent — avec un contrôle complet sur les champs que vous extrayez, à quelle granularité et selon quel calendrier.
Le parcours d’approbation standard
Si vous poursuivez un accès API :
- Configurez un compte Manager (MCC) approprié si vous n’en avez pas déjà un. Les comptes clients ne peuvent pas détenir de developer tokens.
- Naviguez vers Outils → Centre API et cliquez sur « Demander un accès Basic ».
- Rédigez une description de cas d’usage spécifique et détaillée. Nommez les rapports exacts dont vous avez besoin, l’objectif commercial et le système de destination (par exemple, BigQuery). Ne mentionnez pas d’outils open source.
- Assurez-vous que votre site web est complet, avec une vraie politique de confidentialité et une description claire de l’activité.
- Soumettez et attendez. Consultez le tableau de bord du Centre API pour les mises à jour de statut.
- En cas de rejet, lisez attentivement la raison. La lettre de rejet identifie généralement le problème de politique spécifique, et vous pouvez l’adresser dans une nouvelle candidature — mais vous ne pouvez pas resoumettre avant que les problèmes soient résolus.
Portée du token et structure MCC
Un developer token couvre l’intégralité de votre MCC. Vous n’avez pas besoin de tokens séparés par compte client. Le token authentifie votre application ; vous spécifiez ensuite quel Customer ID vous interrogez dans chaque appel API. C’est important pour les agences ou consultants gérant plusieurs comptes annonceurs — un seul token avec un accès au niveau MCC peut récupérer des données sur tous les comptes clients.
Lors de la soumission de la candidature de token, précisez que vous accédez à plusieurs comptes clients sous un MCC. C’est le cas d’usage d’agence standard et les réviseurs le reconnaissent, mais vous devez le décrire avec précision.
Ce qui se passe après l’approbation
Avec un token Basic ou Standard, vous pouvez l’utiliser directement dans des pipelines dlt, des scripts Python personnalisés, ou n’importe quel outil qui accepte un developer token. Configurez-le avec vos credentials OAuth (le token authentifie l’application ; OAuth authentifie le compte utilisateur accédant aux données).
Le token lui-même n’expire pas, mais il peut être révoqué pour violation des conditions d’utilisation. Gardez-le hors du contrôle de version, stockez-le dans des variables d’environnement ou un gestionnaire de secrets, et surveillez les communications de politique de Google.
Pour le paysage complet de la façon dont le developer token s’intègre dans les différentes approches de chargement, voir Ad Data Extraction Tools et le Google Ads BigQuery Loading Hub. Pour l’option native sans token, voir Google Ads BigQuery DTS Hub. Pour construire un pipeline une fois que vous avez un token, voir dlt Google Ads Pipeline.