Votre projet Google Cloud 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 projet est autorisé à utiliser.
Niveaux d'accès
Le tableau ci-dessous présente les quatre niveaux d'accès à l'API par ordre croissant. Si vous n'avez pas encore accès à l'API Google Ads, vous pouvez commencer par l'activer pour obtenir le niveau d'accès "Compte de test" pour votre projet Google Cloud. 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érations 1 | 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 | Demander l'accès "Compte de test" | |
| Niveau d'accès "Explorateur" | 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 |
Demander l'accès "Explorateur" | |
| 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 | Demander l'accès "De base" | |
| 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 | Demander l'accès "Standard" | 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 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.
Niveau d'accès "Compte de test"
Une fois l'API Google Ads activée, votre projet Google Cloud reçoit le niveau d'accès "Compte de test". Cela signifie que le projet 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"
Activez l'API Google Ads dans votre projet Google Cloud pour obtenir automatiquement le niveau d'accès "Compte de test" pour votre projet.
Niveau d'accès "Explorateur"
Une fois votre inscription initiale à l'API Google Ads terminée, Google peut vous autoriser à demander le niveau d'accès "Explorateur".
Le niveau d'accès "Explorateur" permet à votre projet Google Cloud 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 "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 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 | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Facturation et paiement du compte | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Demander le niveau d'accès "Explorateur"
- Accédez à la page "Présentation de l'API Google Ads" dans votre projet Google Cloud.
- Vérifiez que la page affiche votre niveau d'accès actuel comme Test.
- Cliquez pour développer la section Passer à un niveau d'accès supérieur.
- Vérifiez que le niveau d'accès suivant est affiché comme Explorateur.
- Cliquez sur le bouton Demander l'accès pour demander le niveau d'accès "Explorateur".
Google peut automatiquement passer le niveau d'accès à l'API de votre projet au niveau "Explorateur" une fois votre demande envoyée.
Niveau d'accès "De base"
Le niveau d'accès "De base" permet à votre projet Google Cloud 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 à votre projet Google Cloud 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"
- Accédez à la page "Présentation de l'API Google Ads" dans votre projet Google Cloud.
- Vérifiez que la page affiche votre niveau d'accès actuel comme Explorateur.
- Cliquez pour développer la section Passer à un niveau d'accès supérieur.
- Vérifiez que le niveau d'accès suivant est affiché comme De base.
- Vérifiez qu'aucun avertissement n'indique que vous n'avez pas validé votre marque pour votre projet. Si c'est le cas, suivez les instructions pour valider votre marque avant de continuer.
- Cliquez sur le bouton Demander l'accès pour demander le niveau d'accès "De base".
Google peut automatiquement passer le niveau d'accès à l'API de votre projet au niveau "De base" une fois votre demande envoyée.
Niveau d'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 à des restrictions spécifiques, qui continueront de s'appliquer même si votre projet dispose du niveau d'accès "Standard" .
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"
- Accédez à la page "Présentation de l'API Google Ads" dans votre projet Google Cloud.
- Vérifiez que la page affiche votre niveau d'accès actuel comme De base.
- Cliquez pour développer la section Passer à un niveau d'accès supérieur.
- Vérifiez que le niveau d'accès suivant est affiché comme Standard.
- Cliquez sur le bouton Commencer la demande pour commencer la demande 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 public 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 être conforme à la fonctionnalité minimale requise.
Tout au long du processus d'examen, l'équipe Google chargée de la conformité communiquera avec vous à l'aide de votre adresse e-mail. Assurez-vous de répondre rapidement aux questions 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.
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 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 du règlement sur les produits, 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 avec des niveaux 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 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 recommandations | Permet au projet Google Cloud d'accéder à RecommendationService, KeywordPlanIdeaService et KeywordPlanService. Cette option n'est utilisée 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 projet Google Cloud a été approuvé pour le niveau d'accès "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.