Niveaux d'accès et utilisation autorisée

Chaque jeton de développeur de l'API Google Ads se voit attribuer un niveau d'accès et une "utilisation autorisée". Le niveau d'accès détermine si vous pouvez affecter les comptes de production et 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 jeton de développeur est autorisé à utiliser.

Niveaux d'accès

Trois niveaux d'accès différents sont listés dans l'ordre dans le tableau. Si vous n'avez pas encore accès à l'API Google Ads, vous pouvez commencer par vous inscrire afin d'obtenir l'accès au compte test. Vous pouvez augmenter le niveau d'accès en effectuant quelques étapes supplémentaires dans l'application.

Niveau d'accès Peut accéder... Limite quotidienne d'opérations1 Application
Tester l'accès au compte Comptes de test 15 000 opérations par jour Instructions
Accès de base Comptes de test et de production 15 000 opérations par jour Instructions
Accès standard Comptes de test et de production Opérations illimitées / jour Instructions

1 "Par jour" correspond à une période glissante de 24 heures au cours de laquelle des requêtes 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.

Tester l'accès au compte

Une fois l'inscription initiale à l'API Google Ads terminée, vous recevez un jeton de développeur avec le niveau d'accès au compte test. Cela signifie que le jeton de développeur ne peut envoyer des requêtes API Google Ads qu'à des comptes de test.

Demander l'accès au compte test

Remplissez le formulaire d'inscription à l'API Google Ads dans l'interface Web de Google Ads pour obtenir automatiquement le niveau d'accès au compte test.

Accès de base

L'accès de base permet au jeton de développeur d'effectuer des requêtes API Google Ads sur les comptes de test et de production. Les comptes de production diffusent des annonces Google réelles, pas les annonces.

Le niveau d'accès de base permet au jeton de développeur d'exécuter jusqu'à 15 000 opérations par jour. C'est suffisant pour la plupart des développeurs.

Demander l'accès de base

Si vous disposez actuellement d'un jeton de développeur de niveau d'accès au compte test et que vous souhaitez demander un accès au compte de production, remplissez le formulaire de demande d'accès de base. Assurez-vous d'avoir bien suivi ces étapes:

  1. Assurez-vous de disposer déjà d'un jeton de développeur avec un niveau d'accès au compte test.
  2. Vérifiez que l'adresse e-mail de contact de l'API dans le centre API est à jour. Vous ne pourrez pas finaliser votre demande sans une adresse e-mail valide régulièrement vérifiée. Assurez-vous d'avoir associé tous vos comptes Google Ads actifs au compte administrateur à l'aide du jeton d'API.

Accès standard

L'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 à l'accès standard, consultez la page Quotas d'API.

Le niveau d'accès standard n'est accordé qu'aux développeurs qui ont besoin d'opérations illimitées dans l'API Google Ads (grandes entreprises ou outils servant de nombreux utilisateurs, par exemple).

Quel que soit le niveau d'accès, toutes les opérations d'API sont soumises aux limites de débit du système. Pour en savoir plus sur la gestion des erreurs de limitation du débit, consultez Types d'erreurs.

Demander un accès standard

Si vous disposez actuellement d'un niveau d'accès de base et que vous souhaitez demander à bénéficier d'opérations illimitées dans l'API Google Ads, remplissez le formulaire de demande d'accès standard.

Si votre outil est externe, préparez-vous à lui fournir un accès de démonstration. Notez que votre outil doit respecter la fonctionnalité minimale requise.

Utilisation autorisée

L'utilisation autorisée ne s'applique qu'aux jetons d'accès de base et aux jetons d'accès standard. L'utilisation autorisée est alloué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 peut être utilisé, comme indiqué dans le tableau suivant:

Utilisation autorisée Description
Création / Gestion des annonces Ces comptes permettent d'accéder à 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. Il est destiné aux développeurs qui n'utilisent l'API que pour demander des statistiques.
Rechercher des mots clés et des recommandations Autorisez le jeton à accéder à RecommendationService, KeywordPlanIdeaService et KeywordPlanService. Cette option n'est utilisée que par les outils qui nécessitent des suggestions pour faciliter la création et la gestion de campagnes Google Ads.

Modifier l'utilisation autorisée

Si vous avez été approuvé pour le niveau d'accès de base ou standard, vous pouvez remplir la demande de mise à jour de l'utilisation autorisée. Remplissez la demande si vous souhaitez mettre à jour votre autorisation d'utilisation ou autoriser vos clients à accéder à votre outil.