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 agir sur les comptes de production, ainsi que le nombre d'opérations et de requêtes que vous pouvez exécuter chaque jour. 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 les quatre niveaux d'accès des jetons de développeur par ordre. 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 suivant quelques étapes supplémentaires dans l'application.
| Niveau d'accès | Accès à... | Limite d'opérations par jour1 | Modalités de candidature | Combien de temps les examens prennent-ils généralement ? |
|---|---|---|---|---|
| Niveau d'accès "Compte de test" | Comptes de test | 15 000 opérations par jour | Instructions | |
| Niveau d'accès "Explorer" | Comptes de test et de production | 2 880 opérations par jour pour les comptes de production 15 000 opérations par jour pour les comptes de test |
Instructions | |
| Niveau d'accès "De base" | Comptes de test et de production | 15 000 opérations par 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 | Nombre illimité d'opérations par jour pour les comptes de test et de production | Instructions | 10 jours ouvrés |
1 "Par jour" correspond à une période glissante de 24 heures au cours de laquelle des requêtes d'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 "Compte de test"
Une fois que vous vous êtes inscrit à l'API Google Ads, 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"
Niveau d'accès "Explorer"
Une fois que vous vous êtes inscrit à l'API Google Ads, Google peut passer automatiquement votre jeton de développeur du niveau d'accès Compte de test au niveau d'accès "Explorer" dans certains cas. Le niveau d'accès "Explorer" permet au jeton de développeur d'effectuer des requêtes d'API Google Ads sur des 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 "Explorer" permet au jeton de développeur d'exécuter jusqu'à 2 880 opérations par jour sur des 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 "Explorer" limite l'accès aux fonctionnalités suivantes. Si vous devez utiliser ces fonctionnalités, vous devez demander le niveau d'accès "De base" ou "Standard".
| Fonctionnalité limitée | Services et méthodes limités |
|---|---|
| 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 "Explorer"
Finalisez l'inscription à l'API Google Ads dans l'interface Web Google Ads. Dans certains cas, Google peut passer automatiquement votre jeton de développeur au niveau d'accès "Explorer" une fois que vous vous êtes inscrit.
Niveau d'accès "De base"
Le niveau d'accès "De base" permet au jeton de développeur d'effectuer des requêtes d'API Google Ads sur des 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 "De base" permet au jeton de développeur d'exécuter jusqu'à 15 000 opérations par jour. Cela suffit à la plupart des développeurs.
Demander le niveau d'accès "De base"
Si vous disposez d'un jeton de développeur avec le niveau d'accès "Compte de test" ou "Explorer", 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 Compte de test ou Explorer.
Assurez-vous que l'adresse e-mail de contact pour l'API dans le centre d'API est à jour. Vous ne pourrez pas terminer le processus de demande sans une adresse e-mail valide et vérifiée régulièrement. Assurez-vous d'avoir associé tous vos comptes Google Ads actifs au compte administrateur Google Ads avec le jeton d'API.
Cliquez sur la flèche vers le bas à côté de Niveau d'accès , puis sur le lien Demander le niveau d'accès "De base".
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 concernant le 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 d'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 le niveau d'accès "De base", vous pouvez demander le 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 De base.
Assurez-vous que l'adresse e-mail de contact pour l'API dans le centre d'API est à jour. Vous ne pourrez pas terminer le processus de demande sans une adresse e-mail valide et vérifiée régulièrement. Assurez-vous d'avoir associé tous vos comptes Google Ads actifs au compte administrateur Google Ads avec le jeton d'API.
Cliquez sur la flèche vers le bas à côté de Niveau d'accès , puis sur le lien Demander le niveau d'accès "Standard".
Si votre outil est utilisé par des utilisateurs externes, 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 du 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 débit, consultez types d'erreurs.
Les services individuels peuvent appliquer des limites et des restrictions de quota supplémentaires pour des raisons telles que des limitations de conception de produit, des restrictions de règlement sur les produits, des considérations de performances et de 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 les 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 d'annonces | Fournit 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 | Effectue uniquement des requêtes GoogleAdsService.Search
ou GoogleAdsService.SearchStream
ou des appels en lecture seule. Cette option est destinée aux développeurs qui n'utilisent l'API que pour
demander des statistiques.
|
| Recherche de mots clés et de recommandations | Permet au jeton de développeur d'accéder à RecommendationService,
KeywordPlanIdeaService,
et KeywordPlanService.
Cette option n'est utilisée que par les outils qui nécessitent des suggestions pour faciliter la
création et la gestion de 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 pour modifier l'utilisation autorisée. Remplissez la demande si vous souhaitez modifier votre utilisation autorisée ou accorder à vos clients l'accès à votre outil.