Votre projet Google Cloud se voit attribuer 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 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.
Niveaux d'accès
Le tableau ci-dessous présente les quatre niveaux d'accès à l'API. 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 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 ? |
|---|---|---|---|---|
| Test | Comptes de test | 15 000 opérations par jour | Demander l'accès Test | |
| 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 | |
| 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" 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.
Tester l'accès
Une fois l'API Google Ads activée, votre projet Google Cloud bénéficie d'un accès Test. Cela signifie que le projet ne peut effectuer des requêtes d'API Google Ads que sur des comptes de test.
Demander l'accès Test
Activez l'API Google Ads dans votre projet Google Cloud pour bénéficier automatiquement de l'accès 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 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 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 avez besoin d'utiliser ces fonctionnalités, vous devez demander le niveau d'accès de base ou le niveau d'accès standard.
| Fonctionnalités limitées | 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 Mettre à niveau le niveau d'accès.
- Vérifiez que le niveau d'accès suivant s'affiche comme Explorateur.
- Cliquez sur le bouton Demander l'accès pour demander le niveau d'accès Explorateur.
Google peut mettre automatiquement à niveau le niveau d'accès à l'API de votre projet vers 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 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. 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 Mettre à niveau le niveau d'accès.
- Vérifiez que le niveau d'accès suivant s'affiche comme De base.
- Vérifiez qu'aucun avertissement n'indique que vous n'avez pas effectué la validation de la marque pour votre projet. Si c'est le cas, suivez les instructions pour effectuer la validation de la marque avant de continuer.
- Cliquez sur le bouton Demander l'accès pour demander le niveau d'accès de base.
Google peut mettre automatiquement à niveau le niveau d'accès à l'API de votre projet vers 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 Mettre à niveau le niveau d'accès.
- Vérifiez que le niveau d'accès suivant s'affiche comme Standard.
- Cliquez sur le bouton Démarrer 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 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 à 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 progresser votre demande d'accès standard. Une fois l'examen terminé, Google vous enverra par e-mail 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 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 des limitations de conception de produits, des restrictions de règles produit, 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 projets Google Cloud disposant du 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 d'annonces | Fournit 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 | 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 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.