What changes in Google Ads API Developer Assistant v2.0?

Recently, Google introduced an updated version of Google Ads API Developer Assistant v2.0, transforming the tool from a simple code generator into an active partner for automation and diagnostics in the development process. The update simplifies integration with the Google Ads API, improves reliability, and enables developers to work more efficiently with advertising campaigns.

Proactive Support and Automation

Assistant v2.0 no longer just generates code — it helps identify issues, diagnose errors, and automate routine tasks. Key improvements include:

• Improved installation and updates via a single command
• Unified directory structure for code, CSV files, and diagnostic reports
• Tools for detecting and fixing offline conversion tracking errors
• Support for the latest API version (v23)
• Session hooks for workflow automation
• Enhanced GAQL query validation
• Experimental Skills feature for complex procedural tasks

Simplified Installation and Maintenance

• One-command installation: Use the --install-deps flag with install.sh or install.ps1 to automatically install all dependencies (pip, composer, bundler).

• Unified directory structure: All generated code, CSV exports, and diagnostic reports are now stored under a single saved/ directory with organized subdirectories.

• One-command update: Use update.sh to quickly upgrade to the latest API version and add required client libraries.

Conversion Diagnostics and Integration Support

Assistant v2.0 introduces a Conversion Troubleshooting & Diagnostics suite for validating offline conversions.

• New script: api_examples/collect_conversions_troubleshooting_data.py
• The /conversions_support_data command generates structured diagnostic reports, identifies problematic states and high failure rates, and simplifies support requests.

Support for Google Ads API v23

The new version is fully compatible with API v23, providing updated interactive examples and optimized handling of resources and fields, ensuring production-ready code.

Session Hooks and Automation

Assistant now includes SessionStart and SessionEnd hooks, enabling:

• Automatic detection of configuration files in $HOME and copying them into the project directory
• Running queries in Python while responding in the user’s preferred language
• Secure deletion of temporary configurations when the session ends

Enhanced GAQL Validation

Assistant now performs stronger validation of GAQL queries, including checks for:

• Logical errors before execution
• Date segment limitations and finite range requirements
• Complex API edge cases

Skills Feature for Complex Tasks

Skills is an experimental feature that acts as a mini-plugin for complex procedural tasks. It integrates with session hooks to automate initialization and cleanup processes.

Why Upgrade to v2.0

• Reduced trial-and-error during API integration
• Faster and more confident debugging of conversions and reporting pipelines
• Increased reliability and overall developer productivity

Getting Started

• First installation: Clone the repository and run install.sh or install.ps1.

• Upgrading: Back up your custom code from saved_code/ and saved_csv/, delete the old project directory, re-clone the repository, and run the installation script again.

Read this article in Ukrainian.