Les tests sont une étape importante pour créer une intégration réussie de l'API Google Ads, que vous débutiez, que vous gériez une application ou que vous ajoutiez de nouvelles fonctionnalités à une intégration existante. Ce guide présente quelques bonnes pratiques pour tester votre intégration de l'API Google Ads.
Comptes de test et comptes de production
Des comptes de test sont disponibles à des fins de développement. Les comptes de test vous permettent de vérifier que le code et la configuration de votre application fonctionnent comme prévu.
Toutefois, toutes les fonctionnalités ne peuvent pas être testées dans un compte test.
Lorsque les limites du compte de test vous empêchent de tester certaines fonctionnalités de votre intégration, vous pouvez utiliser un compte de production pour le développement. Les comptes de production pour le développement diffèrent des comptes de test de la manière suivante :
- Diffuser des annonces visibles par les utilisateurs
- Exiger des URL valides
- Doit respecter les Règles en matière de publicité
Étant donné que les comptes de production diffusent des annonces, ils génèrent des métriques qui vous permettent de tester les rapports sur les performances et de débloquer toutes les autres fonctionnalités de l'API Google Ads. Toutefois, leur utilisation pour le développement nécessite une prudence particulière. Nous vous recommandons de prendre les mesures suivantes :
- N'accordez l'accès qu'aux utilisateurs qui en ont besoin à des fins de développement.
- Définissez un budget quotidien fixe et faible pour votre compte.
- N'utilisez des comptes de production pour le développement que lorsque les comptes de test ne peuvent pas être utilisés.
Par conséquent, pour tester complètement votre intégration, vous aurez probablement besoin d'identifiants de test et de production.
Identifiants de test
Pour minimiser le risque de modifier accidentellement des comptes de production lorsque vous essayez de modifier des comptes de développement, nous vous recommandons de conserver un ensemble d'identifiants de test distincts de ceux de votre application de production.
Pour créer un ensemble d'identifiants de test :
- Créez un compte de messagerie (par exemple, api.test@example.com) ou un compte de service qui ne sera utilisé qu'à des fins de test.
- Ajoutez cet utilisateur ou ce compte de service en tant qu'utilisateur valide dans les comptes Google Ads sur lesquels vous effectuez vos tests. Veillez à attribuer les niveaux d'accès appropriés à cet utilisateur ou compte de service. N'accordez pas à cet utilisateur ni à ce compte de service l'accès à aucun compte de production.
- Si vous utilisez le flux d'authentification des utilisateurs OAuth 2.0 plutôt que le flux de compte de service, générez un jeton d'actualisation pour votre compte de test.
- Utilisez ces nouveaux identifiants lorsque vous testez votre application. Le jeton de développeur, l'ID client et le code secret du client peuvent être réutilisés à des fins de test, car ils n'ont aucune incidence sur les comptes Google Ads auxquels vous pouvez accéder.
Demande de validation
Si vous avez simplement besoin de tester la validité d'une requête (par exemple, pour vérifier qu'elle est correctement structurée et qu'elle ne viole pas les règles), vous pouvez utiliser le champ validate_only
, qui est disponible pour les requêtes GoogleAdsService.SearchStream
et GoogleAdsService.Search
, ainsi que pour la plupart des requêtes de mutation.
Consultez la documentation de référence pour vérifier si ce champ est disponible pour une méthode donnée.
API REST
Pour les tests ponctuels, par exemple pour vérifier qu'une requête génère le résultat attendu, l'utilisation de l'API REST est souvent l'option la plus simple. Consultez les exemples REST pour découvrir comment utiliser curl pour envoyer des requêtes à l'API REST. Essayez également de tester dans l'explorateur REST.