Chaque jeton de développeur de l'API Google Ads est associé à un niveau d'accès et à une "utilisation autorisée". Le niveau d'accès détermine si vous pouvez affecter les comptes de production, ainsi que le nombre d'opérations et de requêtes que vous pouvez exécuter quotidiennement. L'utilisation autorisée détermine les fonctionnalités spécifiques de l'API Google Ads que le jeton de développeur est autorisé à utiliser.
Niveaux d'accès
Le tableau présente trois niveaux d'accès différents. Si vous n'avez pas encore accès à l'API Google Ads, vous pouvez commencer par vous inscrire pour obtenir l'accès à un compte de test. Vous pouvez augmenter le niveau d'accès en effectuant quelques étapes supplémentaires dans l'application.
| Niveau d'accès | Peut accéder à… | Limite d'opérations quotidiennes1 | Appliquer |
|---|---|---|---|
| Tester l'accès au compte | Comptes de test | 15 000 opérations / jour | Instructions |
| Accès de base | Comptes de test et de production | 15 000 opérations / jour | Instructions |
| Accès standard | Comptes de test et de production | Opérations illimitées par jour | Instructions |
1 "Par jour" fait référence à une période de 24 heures glissante au cours de laquelle des requêtes API ont été effectuées avec votre jeton de développeur. Votre application recevra une erreur si elle dépasse la limite de requêtes pour votre niveau d'accès au cours des dernières 24 heures.
Tester l'accès au compte
Une fois que vous avez terminé l'inscription initiale à l'API Google Ads, un jeton de développeur vous est attribué avec le niveau d'accès "Compte de test". Cela signifie que le jeton de développeur ne peut effectuer des requêtes d'API Google Ads que sur des comptes de test.
Demander l'accès à un compte de test
Inscrivez-vous à l'API Google Ads dans l'interface Web Google Ads pour obtenir automatiquement le niveau d'accès "Compte de test".
Accès de base
Le niveau d'accès de base permet au jeton de développeur d'envoyer des requêtes à l'API Google Ads pour les comptes de test et de production. Les comptes de production sont tous les comptes qui diffusent des annonces Google réelles et en direct. Les comptes de test ne diffusent pas d'annonces.
Le niveau d'accès de base permet au jeton de développeur d'exécuter jusqu'à 15 000 opérations par jour. Cela suffit pour la plupart des développeurs.
Demander un accès de base
Si vous disposez d'un jeton de développeur avec un niveau d'accès à un compte de test et que vous souhaitez demander l'accès à un compte de production, remplissez le formulaire de demande d'accès de base. Assurez-vous d'avoir effectué les étapes suivantes :
- Assurez-vous de disposer déjà d'un jeton de développeur avec un niveau d'accès "Compte de test".
- Assurez-vous que l'adresse e-mail de contact pour l'API dans le centre API est à jour. Vous devez être connecté à votre compte administrateur pour voir le centre API. Vous ne pourrez pas terminer la procédure de demande sans une adresse e-mail valide et régulièrement consultée. Assurez-vous d'avoir associé tous vos comptes Google Ads actifs au compte administrateur avec le jeton API.
Accès standard
Le niveau d'accès standard permet au jeton de développeur d'exécuter un nombre illimité d'opérations par jour pour la plupart des services. Cela inclut, sans s'y limiter, GoogleAdsService Search et SearchStream. Pour en savoir plus sur les limites et les exceptions au niveau d'accès standard, consultez Quotas d'API.
Le niveau d'accès standard n'est accordé qu'aux développeurs qui ont besoin d'un nombre illimité d'opérations de l'API Google Ads, comme les grandes entreprises ou les outils qui servent de nombreux utilisateurs.
Quel que soit le niveau d'accès, toutes les opérations de l'API sont soumises à des limites de débit système. Pour savoir comment gérer les erreurs de limite de débit, consultez Types d'erreurs.
Demander l'accès standard
Si vous disposez d'un jeton de développeur avec un accès de base et que vous souhaitez demander des opérations illimitées avec l'API Google Ads, remplissez le formulaire de demande d'accès standard.
Si votre outil est externe, préparez-vous à fournir un accès de démonstration à votre outil. Notez que votre outil doit respecter les fonctionnalités minimales requises.
Utilisation autorisée
L'utilisation autorisée ne s'applique qu'aux jetons de développeur avec des niveaux d'accès de base et standard. L'utilisation autorisée est allouée en fonction de l'utilisation prévue de l'API Google Ads. Ces autorisations déterminent les fonctionnalités de l'API pour lesquelles un jeton de développeur peut être utilisé, comme indiqué dans le tableau suivant :
| Utilisation autorisée | Description |
|---|---|
| Création / Gestion des annonces | Donne accès à tous les services de l'API pour créer et gérer des campagnes, des groupes d'annonces, des annonces et des mots clés Google Ads. |
| Rapports | N'effectuez que des requêtes GoogleAdsService.Search ou GoogleAdsService.SearchStream, ou des appels en lecture seule. Cette option s'adresse aux développeurs qui n'utilisent l'API que pour demander des statistiques.
|
| Rechercher des mots clés et des recommandations | Autorisez le jeton à accéder à RecommendationService, KeywordPlanIdeaService et KeywordPlanService. Elle n'est utilisée que par les outils qui ont besoin de suggestions pour faciliter la création et la gestion des campagnes Google Ads. |
Modifier l'utilisation autorisée
Si votre jeton de développeur a été approuvé pour le niveau d'accès de base ou standard, vous pouvez remplir la demande de mise à jour de l'utilisation autorisée. Remplissez la demande si vous souhaitez mettre à jour votre utilisation autorisée ou accorder à vos clients l'accès à votre outil.