Google Ads API Explorer

API Google Ads Explorer est un environnement d'exécution interactif qui vous permet de créer et d'envoyer des requêtes API en direct directement depuis votre navigateur. Intégré à la documentation de référence, il gère la complexité de l'authentification OAuth 2.0 et de la mise en forme de la charge utile JSON, ce qui vous permet de tester des services et des méthodes spécifiques sans écrire une seule ligne de code.

Avantages

  • Tests sans code : exécutez des appels d'API en direct (en lecture et en écriture) directement à partir de la documentation sans configurer d'environnement de développement local.
  • Découverte de protocoles : consultez la structure exacte des requêtes et des réponses HTTP pour comprendre le comportement de l'API.
  • Prototypage à faible friction : vérifiez le comportement des points de terminaison et inspectez les réponses brutes de l'API instantanément avant d'implémenter la logique dans votre application.
  • Authentification simplifiée : l'outil gère automatiquement les flux OAuth 2.0, ce qui vous permet de vous concentrer sur la requête API plutôt que sur la gestion des identifiants.

Premiers pas

  1. Accédez à la documentation : accédez à la documentation de référence et sélectionnez le service et la méthode que vous souhaitez tester, par exemple GoogleAdsService/Search.
  2. Ouvrez l'explorateur : recherchez le panneau "Try it!" (Essayez-le !) sur le côté droit de la page.
  3. Configurez la requête
    • Saisissez les paramètres de requête requis, tels que developer-token et login-customer-id.
    • Définissez le corps de la requête à l'aide de l'éditeur JSON interactif si la méthode nécessite une charge utile, par exemple pour les opérations mutate.
  4. Exécutez : cliquez sur "Execute" (Exécuter) pour envoyer la requête. L'outil affiche la requête HTTP complète et la réponse JSON en direct de l'API.

Principales fonctionnalités

  • Exécution en direct : effectuez des opérations search et mutate en temps réel sur vos comptes de production ou de test.
  • Mise en forme de la charge utile JSON : créez de manière interactive des objets JSON complexes pour les requêtes. L'outil met en évidence les champs obligatoires et les structures de schéma valides.
  • Masques de champ : testez une logique update_mask pour voir comment les mises à jour partielles des ressources se comportent en pratique.
  • Inspection des erreurs : affichez des messages et des codes d'erreur détaillés (tels que QUERY_ERROR ou AUTHENTICATION_ERROR) dans la réponse brute pour faciliter le débogage.
  • Exportation de code : exportez des commandes curl, des requêtes HTTP brutes ou des exemples de code JavaScript à partir de la vue développée de l'API Explorer.

Exemples de cas d'utilisation

  • Auditer les paramètres du compte : récupérez rapidement les configurations ou les métadonnées au niveau du compte en exécutant une requête get ou search.
  • Tester les mutations : vérifiez la réussite de la création d'une campagne ou de la mise à jour d'un budget avant de déployer le code en production.
  • Déboguer GAQL : utilisez l'explorateur pour exécuter une chaîne de langage de requête Google Ads (GAQL) et vérifiez que la structure JSON renvoyée correspond aux attentes de votre application.
  • Vérification du protocole : inspectez les en-têtes HTTP exacts et l'imbrication JSON requis pour une version d'API spécifique.