Chaque jeton de développeur de l'API Google Ads se voit attribuer 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
Il existe trois niveaux d'accès différents, classés par ordre dans le tableau. Si vous ne disposez pas encore d'un accès à l'API Google Ads, vous pouvez commencer par vous inscrire pour obtenir l'accès au compte de test. Vous pouvez augmenter le niveau d'accès en effectuant des é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 par jour | Instructions |
| Accès de base | Comptes de test et de production | 15 000 opérations par jour | Instructions |
| Accès standard | Comptes de test et de production | Nombre illimité d'opérations par jour | Instructions |
1 Par jour, il est basé sur une période glissante de 24 heures 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 l'inscription initiale à l'API Google Ads terminée, vous recevez un jeton de développeur avec le niveau d'accès au compte de test. Cela signifie que le jeton de développeur ne peut envoyer des requêtes API Google Ads qu'à des comptes de test.
Demander l'accès au compte de test
Inscrivez-vous à l'API Google Ads dans l'interface Web Google Ads pour obtenir automatiquement le niveau d'accès au compte de test.
Accès de base
L'accès de base permet au jeton de développeur d'envoyer des requêtes API Google Ads à la fois aux comptes de test et aux comptes de production. Les comptes de production sont ceux qui diffusent de véritables annonces Google 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 actuellement d'un jeton de développeur de niveau d'accès au 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'un jeton de développeur avec un niveau d'accès au compte de test.
- Assurez-vous que l'adresse e-mail de contact de l'API dans le centre API est à jour. Vous ne pourrez pas finaliser la procédure de demande sans une adresse e-mail valide et régulièrement vérifiée. Assurez-vous d'avoir associé tous vos comptes Google Ads actifs au compte administrateur à l'aide du jeton d'API.
Accès standard
L'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 à l'accès standard, consultez la page Quotas d'API.
Le niveau d'accès standard n'est accordé qu'aux développeurs ayant besoin d'un nombre illimité d'opérations dans l'API Google Ads, tels que de grandes entreprises ou des outils qui desservent de nombreux utilisateurs.
Quel que soit le niveau d'accès, toutes les opérations d'API sont soumises aux limites de débit du système. Pour en savoir plus sur la gestion des erreurs de limitation du débit, consultez la section Types d'erreur.
Demander un accès standard
Si vous disposez actuellement d'un niveau d'accès de base et que vous souhaitez demander un nombre illimité d'opérations dans l'API Google Ads, remplissez le formulaire de demande d'accès standard.
Si votre outil est externe, préparez-vous à lui fournir un accès de démonstration. Notez que votre outil doit respecter les fonctionnalités minimales requises.
Utilisation autorisée
L'utilisation autorisée ne s'applique qu'aux jetons d'accès de base et standard. L'utilisation autorisée est attribué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 peut être utilisé, comme expliqué dans le tableau suivant:
| Utilisation autorisée | Description |
|---|---|
| Création / Gestion des annonces | Ils permettent d'accéder à tous les services de l'API pour la création et la gestion des campagnes, groupes d'annonces, annonces et mots clés Google Ads. |
| Fréquence | N'effectuez que des requêtes GoogleAdsService.Search ou GoogleAdsService.SearchStream, ou des appels en lecture seule. Il est destiné aux développeurs qui n'utilisent l'API que pour demander des statistiques.
|
| Rechercher des mots clés et des recommandations | Autoriser le jeton à accéder à RecommendationService, KeywordPlanIdeaService et KeywordPlanService. Elle n'est utilisée que par les outils nécessitant des suggestions pour faciliter la création et la gestion des campagnes Google Ads. |
Modification de l'utilisation autorisée
Si vous avez été approuvé pour le niveau d'accès de base ou standard, vous pouvez remplir le formulaire de demande de mise à jour de l'utilisation autorisée. Remplissez la demande si vous souhaitez modifier votre utilisation autorisée ou autoriser vos clients à accéder à votre outil.