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
Le tableau ci-dessous présente 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 "Accès au compte de test". Vous pouvez augmenter le niveau d'accès en suivant quelques étapes supplémentaires dans l'application.
| Niveau d'accès | Peut accéder à… | Limite d'opérations quotidiennes1 | 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 | 5 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 |
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.
Niveau d'accès au compte test
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 le niveau d'accès "Compte de test"
Inscrivez-vous à l'API Google Ads dans l'interface Web 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, 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" limite 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 | CustomerUserAccessInvitationServiceCustomerUserAccessService
|
| Planification |
KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceKeywordPlanIdeaServiceReachPlanService |
| Facturation et paiement du compte |
PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Demander le niveau d'accès Explorateur
Inscrivez-vous à l'API Google Ads dans l'interface Web de Google Ads. Dans certains cas, Google peut automatiquement mettre à niveau votre jeton de développeur vers le niveau d'accès "Explorateur" une fois l'inscription terminée.
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 "Accès au compte de test" ou "Accès Explorateur", vous pouvez demander le niveau d'accès de base comme suit :
Accédez à https://ads.google.com/aw/apicenter dans votre navigateur Web. Connectez-vous à votre compte administrateur Google Ads si vous y êtes invité.
Vérifiez que votre niveau d'accès est défini sur Compte de test ou Explorateur.
Assurez-vous que l'adresse e-mail de contact pour l'API dans le centre d'API est à jour. 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 Google Ads avec le jeton API.
Cliquez sur la flèche du menu déroulant à côté de Niveau d'accès, puis sur le lien Demander l'accès de base.
Valider la marque des projets Google Cloud
L'API Google Ads utilise l'état de validation de la marque des projets Google Cloud associés à un jeton de développeur lorsqu'elle examine les demandes d'accès de base. Vous pouvez effectuer la procédure de validation de la marque dans votre projet Google Cloud pour accélérer l'examen de votre demande d'accès de base. Dans certains cas, Google peut également vous demander de valider votre marque dans vos projets Google Cloud avant de traiter votre demande d'accès de base. Pour en savoir plus, consultez le guide sur la validation des marques.
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, vous pouvez demander un niveau d'accès standard comme suit :
Accédez à https://ads.google.com/aw/apicenter dans votre navigateur Web. Connectez-vous à votre compte administrateur Google Ads si vous y êtes invité.
Vérifiez que votre niveau d'accès est défini sur Basique.
Assurez-vous que l'adresse e-mail de contact pour l'API dans le centre d'API est à jour. 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 Google Ads avec le jeton API.
Cliquez sur la flèche du menu déroulant à côté de Niveau d'accès, puis sur le lien Demander l'accès standard.
Si votre outil est utilisé par des utilisateurs externes, préparez-vous à leur fournir un accès de démonstration. 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 de l'API sont soumises à des limites de fréquence 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 en savoir plus sur la gestion des erreurs de limite de fréquence, consultez Types d'erreurs.
Chaque service peut appliquer des limites et des restrictions de quota supplémentaires pour diverses raisons, comme des limites de conception du produit, des restrictions liées aux règles du produit, des considérations liées aux performances et à la latence des 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.