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, 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 projet est autorisé à utiliser.
Niveaux d'accès
Le tableau liste quatre niveaux d'accès à l'API différents. 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. 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 quotidiennes 1 | Modalités de candidature | Combien de temps dure généralement le processus d'examen ? |
|---|---|---|---|---|
| Test | Comptes de test | 15 000 opérations / jour | Demander un accès au 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 à Explorer | |
| De base | Comptes de test et de production | 15 000 opérations / jour pour les comptes de test et de production | Demander un 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" 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 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 l'API Google Ads activée, l'accès test est accordé à votre projet Google Cloud. Cela signifie que le projet ne peut envoyer des requêtes à l'API Google Ads que pour des comptes de test.
Demander un accès test
Activez l'API Google Ads dans votre projet Google Cloud pour obtenir automatiquement un accès test à votre projet.
Niveau d'accès "Explorateur"
Une fois l'inscription initiale à l'API Google Ads terminée, Google peut vous permettre de demander le niveau d'accès "Explorateur".
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 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 Explorateur permet à votre projet Google Cloud 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 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 le niveau d'accès Explorateur
- Accédez à la page de 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 Mettre à niveau le niveau d'accès.
- Vérifiez que le prochain niveau d'accès est défini sur Explorateur.
- Cliquez sur le bouton Demander l'accès pour demander le niveau d'accès Explorateur.
Google peut mettre à niveau automatiquement le niveau d'accès aux API de votre projet vers "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 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 pour la plupart des développeurs.
Demander le niveau d'accès de base
- Accédez à la page de 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 Mettre à niveau le niveau d'accès.
- Vérifiez que le prochain niveau d'accès est défini sur Standard.
- Vérifiez qu'aucun avertissement n'indique que vous n'avez pas validé la 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 mettre à niveau automatiquement le niveau d'accès à l'API de votre projet vers le niveau Basic une fois votre demande envoyée.
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. Des limites de débit et des restrictions spécifiques à certains services et fonctionnalités peuvent toujours 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'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
- Accédez à la page de 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 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 la demande pour commencer à demander le 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 respecter les fonctionnalités minimales requises.
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 Conformité pour que votre demande d'accès standard soit traitée. Une fois l'examen terminé, Google vous enverra un e-mail vous informant du 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 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 savoir comment gérer les erreurs de limite de fréquence, consultez les types d'erreurs.
Chaque service peut appliquer des limites et des restrictions de quota supplémentaires pour des raisons telles que les limites de conception du produit, les restrictions liées aux règles du produit, les considérations relatives aux performances et à la 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 projets Google Cloud dont le niveau d'accès est "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 | 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 projet Google Cloud à accéder à RecommendationService, KeywordPlanIdeaService et KeywordPlanService. Il n'est utilisé 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 projet Google Cloud a été approuvé pour le niveau d'accès "Standard", vous pouvez remplir le formulaire de demande de mise à jour de l'utilisation autorisée. Remplissez le formulaire de demande si vous souhaitez mettre à jour votre utilisation autorisée ou accorder à vos clients l'accès à votre outil.