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, classés 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 le 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 quotidienne d'opérations1 | 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 / jour | Instructions | |
| Niveau d'accès "Explorer" | 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 | Nombre illimité d'opérations / 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 avez terminé l'inscription initiale à 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 avez terminé l'inscription initiale à l'API Google Ads, Google peut faire 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 avez besoin d' utiliser ces fonctionnalités, vous devez demander le niveau d'accès "De base" ou "Standard".
| Fonctionnalités limitées | 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 faire passer automatiquement votre jeton de développeur au niveau d'accès "Explorer" 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'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 la procédure 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".
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 lors de l'examen des demandes de niveau 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 de niveau d'accès "De base". Dans certains cas, Google peut également vous demander de valider votre marque dans vos projets Google Cloud comme condition préalable au traitement de votre demande de niveau d'accès "De base". Pour en savoir plus, consultez le guide sur la validation de la marque.
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 la section 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 la procédure 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 la section Types d'erreurs.
Les services individuels peuvent appliquer des limites et des restrictions de quota supplémentaires pour des raisons telles que les limites de conception des produits, les restrictions des règles produit, les considérations sur les 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 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. Cela s'adresse 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.
Cela n'est utilisé que par les outils nécessitant 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 le formulaire de demande pour modifier l'utilisation autorisée. Remplissez le formulaire si vous souhaitez modifier votre utilisation autorisée ou accorder à vos clients l'accès à votre outil.