Google Ads API Explorer

Google Ads API 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 les complexités 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 depuis la documentation, sans configurer d'environnement de développement local.
  • Découverte du protocole : 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 immédiatement 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.

Commencer

  1. Accédez à la documentation : accédez à la documentation de référence, puis sélectionnez le service et la méthode que vous souhaitez tester, par exemple GoogleAdsService/Search.
  2. Ouvrez l'explorateur : recherchez le panneau Essayer cette méthode sur le côté droit de la page.
  3. Configurez la requête :
    • Saisissez les paramètres de requête requis, tels que customerId, puis développez En-têtes pour fournir des en-têtes HTTP facultatifs tels que login-customer-id (requis uniquement lors de l'accès à un compte via un compte administrateur). Notez que les jetons de développeur (developer-token) ont été abandonnés le 9 septembre 2026 et sont ignorés par les serveurs d'API, même si vous pouvez toujours saisir une valeur si le formulaire vous y invite.
    • 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 search ou mutate.
  4. Exécuter : cliquez sur 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 mettant en évidence les champs obligatoires et les structures de schéma valides.
  • Masques de champ : testez la logique update_mask pour voir comment les mises à jour partielles de ressources se comportent en pratique.
  • Inspection des erreurs : affichez les messages et les 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 un exemple de code JavaScript à partir de la vue développée d'APIs 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 GoogleAdsService/Search sur la ressource customer.
  • Tester les mutations : vérifiez qu'une campagne a bien été créée ou qu'un budget a bien été mis à jour avant de déployer le code en production.
  • Déboguer GAQL : utilisez l'explorateur pour exécuter une chaîne Google Ads Query Language (GAQL) et vérifier 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 requise pour une version d'API spécifique.