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 (en lecture et en écriture) directement à partir de 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 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 la droite 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, comme pour les opérations `mutate`.
  4. Exécuter : cliquez sur "Exécuter" pour envoyer la requête. L'outil affichera 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 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 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 get ou search.
  • Tester les 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 du 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 : examinez les en-têtes HTTP et l'imbrication JSON exacts requis pour une version spécifique de l'API.