Google Ads API Explorer

L'explorateur d'API Google Ads est un environnement d'exécution interactif qui vous permet de créer et d'envoyer des requêtes d'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 du formatage des charges utiles 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 (lecture et é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 d'API plutôt que sur la gestion des identifiants.

Commencer

  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 Essayer cette méthode sur la droite 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 les en-têtes HTTP facultatifs, tels que login-customer-id (obligatoire uniquement lorsque vous accédez à 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. Vous pouvez toutefois 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, comme 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 met en évidence les champs obligatoires et les structures de schéma valides.
  • Masques de champ : testez la logique update_mask pour voir comment se comportent les mises à jour partielles des ressources en pratique.
  • Inspection des erreurs : affichez les messages et 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'explorateur d'API.

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.
  • Tests de mutations : vérifiez que la création d'une campagne ou la mise à jour d'un budget ont réussi 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érifiez que la structure JSON renvoyée correspond aux attentes de votre application.
  • Vérification du protocole : examinez les en-têtes HTTP et l'imbrication JSON exacts requis pour une version spécifique de l'API.