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 des comptes de production, ainsi que le nombre d'opérations et de requêtes que vous pouvez exécuter chaque jour. La l'utilisation autorisée détermine les fonctionnalités spécifiques de l'API Google Ads que le jeton du développeur est autorisé à utiliser.
Niveaux d'accès
Trois niveaux d'accès différents sont listés dans l'ordre dans le tableau. Si vous n'avez pas encore accès à l'API Google Ads, vous pouvez commencer par vous inscrire pour obtenir un 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 | A accès à... | 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" est basé sur une période glissante de 24 heures pendant laquelle des requêtes d'API ont été effectuées avec votre jeton de développeur. Votre application recevra un message d'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, vous recevez un jeton de développeur avec le niveau d'accès du compte de test. Cela signifie que le jeton de développeur ne peut effectuer de requêtes 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 du compte de test.
Accès de base
L'accès de base permet au jeton de développeur d'effectuer des requêtes d'API Google Ads à la fois sur les comptes de test et les comptes de production. Les comptes de production sont des comptes qui diffusent des annonces Google réelles. 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 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éjà d'un jeton de développeur avec un niveau d'accès de compte de test.
- Assurez-vous que l'adresse e-mail de contact de l'API dans le centre API est à jour. Vous devez être connecté à votre compte administrateur pour accéder au centre API. Vous ne pourrez pas finaliser le processus de candidature 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 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, les éléments suivants : GoogleAdsService Search et SearchStream. Pour en savoir plus sur les limites et les exceptions à l'accès standard, consultez la section Quotas d'API.
Le niveau d'accès standard n'est accordé qu'aux développeurs qui ont besoin d'opérations illimitées 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 aux limites de débit système. Pour en savoir plus sur la gestion des erreurs de limite de débit, consultez la section Types d'erreurs.
Demander un accès standard
Si vous disposez actuellement d'un niveau d'accès de base et que vous souhaitez demander un accès illimité aux opérations de l'API Google Ads, remplissez le formulaire de demande d'accès standard.
Si votre outil est externe, soyez prêt à 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 d'accès de base et standards. 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 indiqué dans le tableau suivant:
| Utilisation autorisée | Description |
|---|---|
| Création / Gestion des annonces | Fournissez un 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. Cette fonctionnalité n'est utilisée que par les outils nécessitant des suggestions pour faciliter la création et la gestion des campagnes Google Ads. |
Modifier l'utilisation autorisée
Si vous avez obtenu l'accès de base ou le niveau d'accès standard, vous pouvez remplir la demande de modification de l'utilisation autorisée. Remplissez la demande si vous souhaitez modifier votre utilisation autorisée ou accorder à vos clients l'accès à votre outil.