Introducing the Google Ads API Developer Assistant v1.0: Interact with the API using Natural Language

Announcing the release of the Google Ads API Developer Assistant, a powerful extension for Gemini CLI designed to streamline your Google Ads API workflows. This tool allows you to interact with the Google Ads API using everyday language, making it easier than ever to get information, generate code, and even retrieve data directly in your terminal.
Whether you're new to the Google Ads API or a seasoned developer, this assistant can help you work more efficiently.

What Can It Do?

The Google Ads API Developer Assistant (v1.0) enhances the Gemini CLI with several key features:

  1. Natural Language Q&A: Have questions about the Google Ads API? Just ask!
    • "What are the available campaign types?"
    • "Tell me about reporting for Performance Max campaigns."
    • "How do I filter by date in GAQL?"
  2. Natural Language to Code Generation: Describe what data you need, and the assistant will generate the Google Ads Query Language (GAQL) and executable Python code using the google-ads-python client library as context so the code conforms to best practices.
    • "Show me campaigns with the most conversions in the last 30 days."
    • "Get all ad groups for customer '123-456-7890'."
    • "Find disapproved ads across all campaigns."
    • Generated code is automatically saved to the saved_code/ directory.
  3. Direct API Execution: Run the generated Python scripts directly from the command line. The assistant will execute the read-only API calls and display the results, often formatted neatly as tables within your terminal.
  4. CSV Export: Need to save your data? You can easily export the tabular results from API calls to a CSV file. Just ask:
    • "Save the results to a CSV file"
    • Files are saved in the saved_csv/ directory.

How Does It Work?

This extension leverages the Gemini CLI's ability to use context from GEMINI.md files and settings within .gemini/settings.json. By configuring the assistant with paths to your local google-ads-python library clone and example directories, it provides relevant and accurate code generation.

Getting Started

Here's what you need to get up and running:
Prerequisites:

  • Familiarity with Google Ads API concepts and authentication.
  • A Google Ads API developer token.
  • A configured google-ads.yaml credentials file in your home directory.
  • Python >= 3.10.
  • The Gemini CLI installed.
  • A local copy of the google-ads-python client library. (The setup script can clone this for you.)

Please refer to the README file in the GitHub repository for detailed setup instructions and examples.

Where to Find It

The Google Ads API Developer Assistant is available on GitHub.

Community & Support

We encourage you to try it out! Your feedback is valuable and can be provided in this survey. Join the discussion in the #ads-api-ai-tools channel of our Discord.

Please use the GitHub Issues tab in the repository to report bugs, suggest features, or ask for support. Check out CONTRIBUTING.md for contribution guidelines.

Happy Coding!
Bob Hancock, Google Ads API Team

Introducing the Google Ads API Developer Assistant v1.0: Interact with the API using Natural Language

Announcing the release of the Google Ads API Developer Assistant, a powerful extension for Gemini CLI designed to streamline your Google Ads API workflows. This tool allows you to interact with the Google Ads API using everyday language, making it easier than ever to get information, generate code, and even retrieve data directly in your terminal.
Whether you're new to the Google Ads API or a seasoned developer, this assistant can help you work more efficiently.

What Can It Do?

The Google Ads API Developer Assistant (v1.0) enhances the Gemini CLI with several key features:

  1. Natural Language Q&A: Have questions about the Google Ads API? Just ask!
    • "What are the available campaign types?"
    • "Tell me about reporting for Performance Max campaigns."
    • "How do I filter by date in GAQL?"
  2. Natural Language to Code Generation: Describe what data you need, and the assistant will generate the Google Ads Query Language (GAQL) and executable Python code using the google-ads-python client library as context so the code conforms to best practices.
    • "Show me campaigns with the most conversions in the last 30 days."
    • "Get all ad groups for customer '123-456-7890'."
    • "Find disapproved ads across all campaigns."
    • Generated code is automatically saved to the saved_code/ directory.
  3. Direct API Execution: Run the generated Python scripts directly from the command line. The assistant will execute the read-only API calls and display the results, often formatted neatly as tables within your terminal.
  4. CSV Export: Need to save your data? You can easily export the tabular results from API calls to a CSV file. Just ask:
    • "Save the results to a CSV file"
    • Files are saved in the saved_csv/ directory.

How Does It Work?

This extension leverages the Gemini CLI's ability to use context from GEMINI.md files and settings within .gemini/settings.json. By configuring the assistant with paths to your local google-ads-python library clone and example directories, it provides relevant and accurate code generation.

Getting Started

Here's what you need to get up and running:
Prerequisites:

  • Familiarity with Google Ads API concepts and authentication.
  • A Google Ads API developer token.
  • A configured google-ads.yaml credentials file in your home directory.
  • Python >= 3.10.
  • The Gemini CLI installed.
  • A local copy of the google-ads-python client library. (The setup script can clone this for you.)

Please refer to the README file in the GitHub repository for detailed setup instructions and examples.

Where to Find It

The Google Ads API Developer Assistant is available on GitHub.

Community & Support

We encourage you to try it out! Your feedback is valuable and can be provided in this survey. Join the discussion in the #ads-api-ai-tools channel of our Discord.

Please use the GitHub Issues tab in the repository to report bugs, suggest features, or ask for support. Check out CONTRIBUTING.md for contribution guidelines.

Happy Coding!
Bob Hancock, Google Ads API Team

Protect sensitive Google Vault actions with multi-party approvals

What’s changing

We are extending multi-party approvals (MPA) to Google Vault. Last year, we launched MPA to protect customers from malicious actors taking sensitive admin actions by requiring that one admin must approve certain actions initiated by another.

Going forward, admins can configure multi-party approvals for the following sensitive Google Vault actions:

  • Google Vault: create export: Requiring approval before a search query can be exported.
When enabled, if an admin attempts to perform these actions in the Vault interface, they will see a "Multi-party approval required" prompt. The action will not be executed until a separate, authorized administrator reviews and approves the request within the Admin console.


Vault admins have access to highly sensitive actions, including the ability to search and export specific sensitive user data or large amounts of data across an entire domain.

Multi-party approval adds an extra layer of security for these sensitive actions by ensuring no sensitive action happens in a silo and, most importantly, helps prevent unauthorized or accidental changes from being made. This dual-authorization mechanism significantly reduces the risk of unauthorized or malicious actions, such as a bad actor attempting to exfiltrate confidential information or perform unapproved data deletions.

Additional details

  • Request workflow: Once a request is submitted, approvers (super admins or delegated admins with the multi-party approval role) receive an email notification.
  • Expiration: Requests expire after three days if not approved.
  • Granular control: Admins can choose to enable MPA specifically for Vault actions without enforcing it on other settings, or vice versa, via the Multi-party approval settings page.
  • Delegation: Super admins can delegate the responsibility of approving these requests to other leaders using the "Multi-party approval" system role.
  • API: Multi-party approval will not be required for exports triggered via the API and should not impact downstream automation via the API.

Getting started

  • Admins: This feature is available for eligible Workspace customers with two or more super admin accounts. Multi-party approval for Vault exports is OFF by default and can be turned on in the Admin console. Visit the Help Center to learn more.

Rollout pace

Availability

Available to Google Workspace

  • Enterprise Standard and Plus
  • Enterprise Essentials Plus
  • Education Standard and Plus

Resources