Un niveau d'accès et une "utilisation autorisée" sont attribués à votre projet Google Cloud. Le niveau d'accès détermine si vous pouvez agir sur les comptes de production et définit 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 projet est autorisé à utiliser.
Accéder à la présentation de l'API Google Ads dans la console Cloud
Niveaux d'accès
Le tableau ci-dessous répertorie les quatre niveaux d'accès à l'API. Si vous n'avez pas encore accès à l'API Google Ads, vous pouvez commencer par activer l'API pour obtenir le niveau d'accès "Test" pour votre projet Google Cloud, puis demander l'accès "Explorateur" sur la page de présentation de l'API Google Ads pour accéder aux comptes de production.
| Niveau d'accès | Accès autorisé... | Limite d'opérations quotidiennes1 | Modalités de candidature | Combien de temps dure généralement l'examen ? |
|---|---|---|---|---|
| Test | Comptes de test | 15 000 opérations par jour | Demander un accès de test | |
| 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 |
Demander l'accès à l'explorateur | |
| De base | Comptes de test et de production | 15 000 opérations par jour pour les comptes de test et de production | Demander l'accès de base | |
| Standard | Comptes de test et de production | Nombre illimité d'opérations par jour pour les comptes de test et de production | Demander l'accès standard | 10 jours ouvrés |
1 "Par jour" est basé sur une période glissante de 24 heures au cours de laquelle des requêtes API ont été effectuées avec votre projet Google Cloud. 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.
Tester l'accès
Une fois que vous avez activé l'API Google Ads, votre projet Google Cloud bénéficie d'un accès test. Cela signifie que le projet ne peut envoyer des requêtes API Google Ads qu'aux comptes de test.
Demander l'accès au test
Activez l'API Google Ads dans votre projet Google Cloud pour obtenir automatiquement un accès de test pour votre projet.
Niveau d'accès Explorer
Une fois que vous avez terminé l'inscription initiale à l'API Google Ads, Google peut vous autoriser à demander le niveau d'accès Explorer.
Le niveau d'accès Explorateur permet à votre projet Google Cloud d'envoyer des requêtes à l'API Google Ads pour les comptes de test et de production. Les comptes de production sont des comptes qui diffusent de vraies annonces Google en ligne. Les comptes de test ne diffusent pas d'annonces.
Le niveau d'accès Explorateur permet à votre projet Google Cloud 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 Explorateur limite l'accès aux fonctionnalités suivantes. Si vous devez utiliser ces fonctionnalités, vous devez demander un niveau d'accès de base ou un niveau d'accès standard.
| Fonctionnalités limitées | Services et méthodes restreints |
|---|---|
| Création d'un compte | CustomerService.CreateCustomerClient |
| Gestion des utilisateurs | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| Planification | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Facturation et paiement du compte | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Demander l'accès au niveau Explorateur
- Accédez à la page Vue d'ensemble de l'API Google Ads de votre projet Google Cloud.
- Vérifiez que la page affiche votre niveau d'accès actuel comme Test.
- Cliquez pour développer la section Mettre à niveau le niveau d'accès.
- Vérifiez que le niveau d'accès suivant est défini sur Explorateur.
- Cliquez sur le bouton Demander l'accès pour demander l'accès au niveau Explorateur.
Google peut automatiquement faire passer le niveau d'accès à l'API de votre projet à "Explorateur" après l'envoi de votre demande.
Niveau d'accès de base
Le niveau d'accès de base permet à votre projet Google Cloud d'envoyer des requêtes à l'API Google Ads pour les comptes de test et de production. Les comptes de production sont des comptes qui diffusent de vraies annonces Google en direct. Les comptes de test ne diffusent pas d'annonces.
Le niveau d'accès de base permet à votre projet Google Cloud d'exécuter jusqu'à 15 000 opérations par jour. Cette option est suffisante pour la plupart des développeurs.
Demander un niveau d'accès de base
- Accédez à la page Vue d'ensemble de l'API Google Ads de votre projet Google Cloud.
- Vérifiez que la page affiche votre niveau d'accès actuel en tant qu'Explorateur.
- Cliquez pour développer la section Mettre à niveau le niveau d'accès.
- Vérifiez que le niveau d'accès suivant est défini sur Basic.
- Vérifiez qu'aucun avertissement n'indique que vous n'avez pas terminé la validation de la marque pour votre projet. Si c'est le cas, suivez les instructions pour valider la marque avant de continuer.
- Cliquez sur le bouton Demander l'accès pour demander le niveau d'accès de base.
Google peut automatiquement faire passer le niveau d'accès à l'API de votre projet à "Accès de base" une fois que vous avez envoyé votre demande.
Accès standard
Le niveau d'accès standard permet à votre projet Google Cloud d'exécuter un nombre illimité d'opérations par jour pour tous les services. Les services et fonctionnalités individuels peuvent toujours être soumis à des limites de débit et restrictions qui leur sont propres, et qui continueront de s'appliquer même si votre projet dispose d'un niveau d'accès standard.
Le niveau d'accès standard n'est accordé qu'aux développeurs qui ont besoin d'effectuer un nombre illimité d'opérations dans l'API Google Ads, comme les grandes entreprises ou les outils qui s'adressent à de nombreux utilisateurs.
Demander l'accès au niveau standard
- Accédez à la page Vue d'ensemble de l'API Google Ads de votre projet Google Cloud.
- Vérifiez que la page affiche votre niveau d'accès actuel comme Standard.
- Cliquez pour développer la section Mettre à niveau le niveau d'accès.
- Vérifiez que le prochain niveau d'accès est défini sur Standard.
- Cliquez sur le bouton Démarrer l'application pour lancer l'application de niveau d'accès standard.
La demande d'accès standard implique un audit manuel détaillé de votre application. Préparez-vous à répondre à des questions sur les fonctionnalités de votre outil et son audience cible. 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.
Tout au long du processus d'examen, l'équipe Google chargée de la conformité communiquera avec vous par e-mail. Veillez à répondre rapidement aux demandes de l'équipe chargée de la conformité pour faire avancer votre demande d'accès standard. Une fois l'examen terminé, Google vous enverra un e-mail avec le résultat final du processus d'examen.
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 limitent 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 limitation du 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 les limites de conception du produit, les restrictions des règles du produit, les performances de l'API et les considérations de latence. 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 projets Google Cloud disposant d'un niveau d'accès 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 que votre outil peut utiliser, comme indiqué dans le tableau suivant :
| Utilisation autorisée | Description |
|---|---|
| Création / Gestion des annonces | Fournir un accès à tous les services de l'API pour créer et gérer des campagnes Google Ads, des groupes d'annonces, des annonces et des mots clés. |
| Rapports | N'effectuez que 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. |
| Rechercher des mots clés et des recommandations | Autorisez le projet Google Cloud à accéder à RecommendationService, KeywordPlanIdeaService et KeywordPlanService. Seuls les outils nécessitant des suggestions pour faciliter la création et la gestion des campagnes Google Ads l'utilisent. |
Modifier l'utilisation autorisée
Si votre projet Google Cloud a été approuvé pour le niveau d'accès standard, vous pouvez remplir la demande de mise à jour 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.