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
Les comptes de test sont disponibles à des fins de développement. Ils 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 de test.
Lorsque les limites des comptes de test vous empêchent de tester certaines fonctionnalités de votre intégration, vous pouvez utiliser un compte de production à la place pour le développement. Les comptes de production pour le développement diffèrent des comptes de test de la manière suivante :
- Ils diffusent des annonces visibles par les utilisateurs.
- Ils nécessitent des URL valides.
- Ils doivent respecter les Règles en matière de publicité.
Comme 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 à des fins de 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 du compte quotidien fixe et faible.
- N'utilisez les 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 d'identifiants 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 vos identifiants d'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 exécutez vos tests. Assurez-vous d'accorder les niveaux d'accès appropriés à cet utilisateur ou à ce compte de service. N'accordez pas à cet utilisateur ou à 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 utilisateur 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 aucun effet sur la détermination des comptes Google Ads auxquels il est possible d'accéder.
Demande de validation
Si vous avez juste besoin de tester si une requête est valide (par exemple, pour
vérifier qu'elle est correctement structurée et qu'elle ne viole pas les
règles), vous pouvez utiliser le
validate_only
champ, qui est disponible pour GoogleAdsService.SearchStream et
GoogleAdsService.Search requêtes, 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 ad hoc, 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.