Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Google Ads sur le serveur de la communauté Google Advertising and Measurement.

Cette page a été traduite par l'API Cloud Translation.

Niveaux d'accès et utilisation autorisée

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. Les conditions d'utilisation autorisées déterminent 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 ci-dessous présente les quatre niveaux d'accès aux jetons de développeur. Si vous n'avez pas encore accès à l'API Google Ads, vous pouvez commencer par vous inscrire pour obtenir un jeton de développeur avec un niveau d'accès "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 quotidiennes¹	Modalités de candidature	Combien de temps dure généralement le processus d'examen ?
Niveau d'accès au compte test	Comptes de test	15 000 opérations / jour	Instructions
Niveau d'accès "Explorateur"	Comptes de test et de production	2 880 opérations / jour pour les comptes de production 15 000 opérations / jour pour les comptes de test	Instructions
Niveau d'accès de base	Comptes de test et de production	15 000 opérations / jour pour les comptes de test et de production	Instructions	Deux jours ouvrés
Niveau d'accès standard	Comptes de test et de production	Opérations illimitées par jour pour les comptes de test et de production	Instructions	10 jours ouvrés

¹ "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.

Niveau d'accès au compte test

Une fois l'inscription initiale à l'API Google Ads terminée, vous recevez un jeton de développeur 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 le niveau d'accès "Compte de test"

Inscrivez-vous à l'API Google Ads dans l'interface Web de Google Ads pour obtenir automatiquement le niveau d'accès "Accès au compte de test".

Niveau d'accès "Explorateur"

Une fois que vous vous êtes inscrit à l'API Google Ads, Google peut, dans certains cas, faire passer automatiquement votre jeton de développeur du niveau d'accès au compte de test au niveau d'accès Explorer. Le niveau d'accès "Explorateur" 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 actives. Les comptes de test ne diffusent pas d'annonces.

Le niveau d'accès "Explorateur" permet au jeton de développeur d'exécuter jusqu'à 2 880 opérations par jour sur les comptes de production. Cela suffit à la plupart des développeurs pour commencer à utiliser l'API et créer une automatisation de base.

Le niveau d'accès "Explorateur" restreint l'accès aux fonctionnalités suivantes. Si vous avez besoin d'utiliser ces fonctionnalités, vous devez demander le niveau d'accès de base ou le niveau d'accès standard.

Fonctionnalités limitées	Services et méthodes soumis à restrictions
Création d'un compte	`CustomerService.CreateCustomerClient`
Gestion des utilisateurs	`CustomerUserAccessInvitationService` `CustomerUserAccessService`
Planification	`KeywordPlanService` `KeywordPlanIdeaService` `KeywordPlanCampaignService` `KeywordPlanCampaignKeywordService` `KeywordPlanAdGroupService` `KeywordPlanAdGroupKeywordService` `AudienceInsightsService` `KeywordPlanIdeaService` `ReachPlanService`
Facturation et paiement du compte	`PaymentsAccountService` `BillingSetupService` `AccountBudgetProposalService` `InvoiceService`

Demander le niveau d'accès Explorateur

Finalisez l'inscription à l'API Google Ads dans l'interface Web de Google Ads. Dans certains cas, Google peut mettre à niveau automatiquement votre jeton de développeur vers le niveau d'accès "Explorateur" une fois que vous avez terminé l'inscription.

Niveau d'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 le niveau d'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 de niveau 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 Google Ads pour accéder au centre API. Vous ne pourrez pas finaliser 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 Google Ads avec le jeton API.

Niveau d'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 desservent de nombreux utilisateurs.

Demander le niveau d'accès standard

Si vous disposez d'un jeton de développeur avec un niveau d'accès de base et que vous souhaitez demander des opérations illimitées de l'API Google Ads, remplissez le formulaire de demande de niveau 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.

Quotas d'API et limites de débit du système

Quel que soit le niveau d'accès, toutes les opérations d'API sont soumises à des limites de débit système, qui restreignent le nombre d'opérations que vous pouvez effectuer sur une période donnée (c'est-à-dire le nombre d'opérations par heure). Pour savoir comment gérer les erreurs de limite de fréquence, consultez la section Types d'erreurs.

Chaque service peut appliquer des limites et des restrictions de quota supplémentaires pour des raisons telles que les limites de conception du produit, les restrictions liées aux règles du produit, les considérations liées aux performances et à la latence de l'API. Pour en savoir plus sur ces restrictions, consultez la documentation sur les quotas d'API.

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 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 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 de développeur à 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 le formulaire de demande si vous souhaitez modifier votre utilisation autorisée ou accorder à vos clients l'accès à votre outil.

Jeton de développeur

Grille tarifaire