Google Ads API Developer Assistant v2.0 Transforms Into Proactive Automation Partner

The update transforms the Assistant into a proactive troubleshooting and automation partner for Google Ads developers, focusing on diagnostics, consistency, and setup. Version 2.0 introduces several key improvements aimed at simplifying API development and enhancing reliability.

Simplified Installation & Maintenance

• One-Command Setup: Use the --install-deps flag with install.sh or install.ps1 to install all dependencies (pip, composer, bundler) at once.
• Unified Directory Structure: All generated code, CSV exports, and diagnostic reports are organized under a single saved/ directory with subdirectories.
• One-Command Update: Use update.sh to upgrade to the latest API version or add client libraries.

Agentic Conversion Troubleshooting

• Introduces a Conversion Troubleshooting & Diagnostics suite to debug offline conversion tracking.
• New script: api_examples/collect_conversions_troubleshooting_data.py.
• New command: /conversions_support_data generates structured diagnostic reports, identifies unhealthy states and high failure rates, and saves results for support requests.

Support for Latest API (v23)

• Full compatibility with Google Ads API v23.
• Updated interactive examples and optimized internal context for the latest resources and fields, ensuring production-ready code.

Seamless Automation with Session Hooks

• Added SessionStart and SessionEnd hooks for frictionless workflows.
• Automatically locates configuration files in the $HOME directory and copies them to the project’s config directory.
• Supports querying in Python (Gemini’s preferred language) while responding in the user’s preferred language.
• Temporary configurations are securely deleted on session exit to keep the workspace clean and credentials safe.

Smarter GAQL Validation

• Updated GEMINI.md and conversions/GEMINI.md with rigorous validation rules for API edge cases.
• Improved handling of date segments and finite range requirements.
• The Assistant now detects logic errors before query execution.

Skills Feature

• Skills act as mini-plugins or "behavior blueprints" loaded only when needed for complex procedural tasks.
• Experimental feature included to complement session hooks for initialization and cleanup.

Reasons to Upgrade

• The leap from v1.6.0 to v2.0.0 emphasizes reliability by integrating deep API knowledge with automated diagnostic tools.
• Reduces trial-and-error in API integration.
• Enables faster, more confident debugging of conversion uploads and building of complex reporting pipelines.

Getting Started

• First installation: Clone the repo and run install.sh or install.ps1.
• Upgrading: Backup custom code from saved_code/ and saved_csv/, delete the old project directory, re-clone the repo, and run the install script again.