Présentation de l'assistant pour les développeurs de l'API Google Ads v3.0.0

Mercredi 10 juin 2026

Nous sommes heureux d'annoncer la sortie de la version 3.0.0 de l'Assistant pour les développeurs de l'API Google Ads. Cette version majeure marque une étape importante dans l'évolution de l'Assistant, en mettant l'accent sur la modernisation de l'architecture, l'amélioration de la fiabilité et une conception plus modulaire.

Avec cette version, nous migrons l'Assistant vers le framework d'agent Google Antigravity et passons à une architecture basée sur les compétences. Ces modifications rendent l'assistant plus robuste, plus facile à gérer et réduisent l'utilisation de jetons.

Nouveautés de la version 3.0.0

1. Basé sur le framework Antigravity

L'assistant pour les développeurs de l'API Google Ads a migré de gemini-cli vers le framework d'agent Antigravity (v3.0.0). Cette mise à niveau du framework sous-jacent fournit un environnement d'exécution plus structuré et plus fiable. De plus, la structure des répertoires et des fichiers du projet a été mise à jour pour être entièrement compatible avec Antigravity.

La prise en charge de gemini-cli prendra fin le 18 juin 2026, comme indiqué dans cette annonce sur le blog Google.

2. Une architecture modulaire basée sur les compétences

Nous avons transformé les fonctionnalités de base de l'Assistant en compétences. Au lieu de s'appuyer sur des instructions générales et non structurées dans un fichier de contexte, l'Assistant charge désormais de manière dynamique des répertoires d'outils spécialisés et testés (compétences) lorsque cela est nécessaire. Cela réduit considérablement les "hallucinations" et garantit que les tâches sont exécutées à l'aide de procédures précises et vérifiées.

Voici les principaux changements apportés par cette transition modulaire :

  • Validation GAQL (validate_gaql) : déplacée vers une compétence dédiée. Il inclut désormais des vérifications de requêtes statiques améliorées pour les segments de date, les filtres d'un jour click_view et les limites change_status.
  • Résoudre les problèmes de conversion (troubleshoot_conversions) : remplace l'ancien conversions_support_package. Il regroupe tous les scripts de dépannage des conversions et de résumé des importations, ainsi que les tests, dans un seul répertoire de compétences cohérent.
  • Commandes structurées (explain et step_by_step) : converties en compétences pour appliquer des mises en page structurées et cohérentes aux explications.
  • Nouveau mappage de compte (get_cids_under_mcc) : nouvelle compétence permettant de récupérer tous les comptes enfants d'un compte administrateur (CM).
  • Nouvelle inspection d'objets (inspect_object) : une nouvelle compétence pour rechercher de manière dynamique des messages et des énumérations Protobuf à la volée, afin de s'assurer que l'Assistant utilise toujours les structures appropriées.
  • Nouveau filtre de fiches PMax (pmax_listing_filter) : nouvelle compétence permettant de standardiser les modifications de l'arborescence d'exclusion de pages Web des groupes de fiches pour les campagnes Performance Max.

3. Cohérence et rigueur renforcées

Nous avons introduit des règles et des exigences plus strictes pour garantir une génération de code et une validation des requêtes de haute qualité :

  • Gestion explicite des versions de l'API : les compétences critiques telles que get_cids_under_mcc, validate_gaql et troubleshoot_conversions nécessitent désormais un argument api_version explicite, ce qui élimine toute ambiguïté.
  • Règles GAQL strictes :
    • Ajout d'une règle à AGENTS.md pour empêcher l'utilisation de fonctions d'agrégation SQL (telles que SUM, COUNT et AVG) dans les requêtes GAQL, car elles ne sont pas acceptées.
    • Ajout d'une règle pour vérifier d'abord les notes de version du site pour les développeurs de l'API Google Ads pour la version actuelle de l'API afin de s'assurer que l'Assistant utilise une documentation à jour.
    • Configuration simplifiée : AGENTS.md a été simplifié, ce qui permet de réduire la fenêtre de contexte initiale. La documentation sur les conversions en double a été supprimée au profit des compétences programmatiques.

4. Améliorations de l'expérience développeur (DX)

Nous avons apporté plusieurs améliorations pour rendre votre boucle de développement plus rapide et plus fluide :

  • Environnement virtuel persistant (.venv) : l'environnement virtuel n'est plus supprimé à la fin d'une session. Au démarrage, l'Assistant vérifie la version de Python de votre système. Il ne recompile le .venv que si une version plus récente de Python est disponible.
  • Mise en cache intelligente de la version de l'API : l'Assistant met désormais en cache la version actuelle de l'API Google Ads avec une durée de vie de 19 heures, ce qui réduit le temps de démarrage en évitant les vérifications réseau redondantes.
  • Débogage amélioré avec les journaux persistants : les messages de journal incluent désormais des codes temporels. Le fichier journal est écrit dans le répertoire .agents/ et n'est plus réinitialisé à chaque exécution, ce qui permet de conserver l'historique pour le dépannage.

Pourquoi passer à un forfait supérieur ?

La mise à niveau vers la version 3.0.0 concerne principalement la fiabilité et la structure. En passant au framework Antigravity et en modularisant les fonctionnalités en Skills, nous avons rendu l'Assistant plus prévisible et plus économe en ressources.

Si vous souhaitez un démarrage plus rapide, une validation GAQL plus fiable et une expérience de dépannage plus robuste, nous vous recommandons de passer à la version 3.0.0.

Commencer

Première installation

  1. Installer la CLI Antigravity : suivez les instructions sur https://antigravity.google/.
  2. Cloner l'assistant : 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. Exécutez le script d'installation :
    • Linux/macOS : exécutez ./install.sh (par défaut, Python est compatible. Utilisez des options telles que --php ou --ruby pour d'autres langages).
    • Windows : ouvrez PowerShell et exécutez .\install.ps1.

Mettre à niveau depuis la version 2.x

  1. Copiez tout code ou toute donnée personnalisés de saved/ vers un emplacement sécurisé en dehors du répertoire du projet.
  2. Supprimez votre clone local de l'Assistant.
  3. Clonez le dépôt :
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. Exécutez le script d'installation (install.sh ou install.ps1) pour initialiser le nouvel environnement Antigravity.

Bob Hancock, équipe API Google Ads

Libellés : google-ads-api, release