Présentation de Google Ads API Developer Assistant v2.0

Jeudi 26 février 2026

Cette mise à jour majeure transforme l'Assistant, qui passe d'un outil puissant de génération de code à un partenaire proactif de dépannage et d'automatisation pour les développeurs Google Ads. Depuis la sortie de la version 1.6.0, nous avons tenu compte de vos commentaires et nous nous sommes concentrés sur les aspects les plus complexes du développement d'API : les diagnostics, la cohérence et la configuration.

Nouveautés de la v2.0

1. Installation et maintenance simplifiées

La configuration d'un environnement de développement multilingue ne devrait pas être une corvée.

  • Configuration en une seule commande : utilisez la nouvelle option --install-deps avec install.sh ou install.ps1 pour gérer les dépendances pip, composer et bundler en une seule fois.
  • Structure de répertoire unifiée : l'ensemble du code généré, des exportations CSV et des rapports de diagnostic est désormais organisé dans un seul répertoire saved/, avec des sous-répertoires pour chaque type de sortie.
  • Mise à jour en une seule commande : lorsqu'une nouvelle version de l'API et des bibliothèques clientes est publiée, vous devez exécuter update.sh pour utiliser la dernière version. Vous pouvez également utiliser update.sh pour ajouter des bibliothèques clientes supplémentaires à votre contexte.

2. Résoudre les problèmes de conversion agentique

Le suivi des conversions hors connexion est l'une des fonctionnalités les plus puissantes, mais aussi les plus complexes, de l'API Google Ads. Déterminer pourquoi une conversion n'a pas été attribuée peut être un processus manuel chronophage.

Dans la version 2.0, nous avons introduit une suite dédiée de diagnostic et de dépannage des conversions.

  • Nouveau script : api_examples/collect_conversions_troubleshooting_data.py
  • Nouvelle commande : /conversions_support_data

Le script exécute des rapports standards pour résoudre les problèmes de conversion et fournit du contexte à l'Assistant pour résoudre vos problèmes.

Cette commande est particulièrement utile une fois que l'assistant a analysé votre problème de conversion et tenté de le résoudre. Si ce n'est pas le cas et que vous devez contacter l'assistance, cette commande analysera vos paramètres client, vos actions de conversion et vos récapitulatifs d'importation pour générer un rapport de diagnostic structuré basé sur l'analyse déjà effectuée. Il identifie même automatiquement les états "non opérationnels" et les taux d'échec élevés, ce qui vous évite de passer des heures à analyser les journaux. Il enregistre les résultats dans un fichier texte que vous pouvez joindre à une demande d'assistance si vous devez en envoyer une.

3. Conçu pour la dernière API (v23)

La version 2.0 est entièrement compatible avec la v23 de l'API Google Ads. Tous nos exemples interactifs ont été mis à jour, et le contexte interne de l'Assistant est désormais optimisé pour les ressources et les champs les plus récents, ce qui garantit que le code que vous générez est prêt pour la production.

4. Automatisation fluide avec les hooks de session

Nous avons ajouté des hooks SessionStart et SessionEnd pour que votre workflow soit vraiment fluide.

  • Configuration automatique : l'Assistant peut désormais localiser automatiquement votre fichier de configuration dans votre répertoire $HOME au début d'une session. Il le copie dans le sous-répertoire "config" du répertoire de votre projet. Python est le langage préféré de Gemini pour interroger l'API. Par conséquent, si vous utilisez un autre langage, il lit votre fichier de configuration et crée un fichier google-ads.yaml temporaire dans config pour ses requêtes, mais continue de répondre dans le code de votre langage préféré.
  • Nettoyage automatique : les configurations temporaires sont effacées de manière sécurisée lorsque vous quittez l'application, ce qui permet de garder votre espace de travail propre et vos identifiants en sécurité.

5. Validation GAQL plus intelligente

Créer des requêtes GAQL complexes n'a jamais été aussi simple. Nous avons mis à jour GEMINI.md et conversions/GEMINI.md avec des règles de validation rigoureuses pour les derniers cas particuliers de l'API, y compris une meilleure gestion des segments de date et des exigences de plage finie. L'Assistant détecte désormais les erreurs de logique avant que vous n'exécutiez la requête.

6. Compétences

Considérez une compétence comme un mini-plug-in ou un "modèle de comportement". Alors que le contexte général (comme votre fichier GEMINI.md) fournit des informations de base, un skill n'est "chargé" dans le cerveau de l'IA que lorsqu'elle doit spécifiquement effectuer une tâche procédurale complexe, comme obtenir la version actuelle de cette extension. Vous n'exécutez pas la compétence directement. Gemini décide quand il en a besoin.

Bien qu'il s'agisse encore d'une fonctionnalité expérimentale, nous en avons inclus une dans cette version pour compléter notre utilisation des hooks pour l'initialisation et le nettoyage des sessions.

Pourquoi passer à la version supérieure ?

Le passage de la version 1.6.0 à la version 2.0.0 ne se limite pas à de nouvelles fonctionnalités : il s'agit d'une question de fiabilité. En intégrant une connaissance approfondie des API à des outils de diagnostic automatisés, la version 2.0 réduit la boucle d'essais et d'erreurs qui ralentit souvent l'intégration des API.

Que vous déboguiez des importations de conversions ou que vous créiez des pipelines de reporting complexes, la v2.0 vous fournit les outils nécessaires pour travailler plus rapidement et en toute confiance.

Premiers pas

Première installation

Mettre à niveau à partir d'une version précédente

  • Copiez tout code personnalisé de saved_code/ et saved_csv/ dans un emplacement sécurisé.
  • Supprimez votre clone local de l'assistant pour les développeurs de l'API Google Ads en supprimant le répertoire de votre projet, ainsi que tous les sous-répertoires et fichiers.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • Dans le répertoire du projet, exécutez install.sh ou install.ps1 pour installer l'extension et les bibliothèques clientes.

Bob Hancock, équipe API Google Ads

Libellés : google-ads-api, release