Google Ads

Connect AI agents to Google Ads. Agents run GAQL reports, list accessible accounts and campaigns, pull campaign metrics, and pause or resume campaigns on spend or performance thresholds.

5 actions available

A scheduled report window opens each morning

Agent runs Search (GAQL) to pull yesterday's performance

Agent appends the figures to a reporting spreadsheet

Agent reads Get Campaign Metrics and compares spend to a threshold

Agent pauses an overspending campaign with Update Campaign Status

Marketing team gets the pause reason and the numbers

Pausing a campaign routes to the account owner before it goes live

What This Integration Enables

An agent can run any Google Ads Query Language query, the universal read operation for campaigns, ad groups, search terms, metrics, and segments. Because GAQL reaches every resource the API exposes, a single flow can pull exactly the report it needs without a fixed set of endpoints. Monetary metrics come back in micros, and the integration converts them to currency units where it reads campaigns directly. Beyond reporting, the agent lists the accounts accessible to the connected user, lists campaigns with their status and core performance, and retrieves aggregated metrics for a single campaign over a date range. The one write operation is a partial mutate that enables or pauses a campaign, leaving all other settings unchanged. Campaign and budget creation is out of scope, so the agent manages status on campaigns built in the Google Ads UI. Google Ads exposes no event triggers in this integration, so flows run on a schedule or start from a threshold check. The agent is the bridge between campaign performance and the systems that report on it and act on it.

Without FlowRunner

Reporting pulled by hand Someone exports Google Ads figures into a spreadsheet each morning

Overspend caught late A campaign runs over budget until the next manual review notices

Guardrails are manual Pausing an underperformer waits for a human to log in and act

With FlowRunner

Reporting pulled on schedule Search (GAQL) reads yesterday's performance into the report automatically

Overspend caught at the threshold Get Campaign Metrics compares spend the moment it crosses the line

Guardrails run in the flow Update Campaign Status pauses the campaign, with a human on the decision

Use Case Scenarios

Daily Performance Report

Each morning the agent runs List Campaigns (or a Search (GAQL) query) to pull yesterday's performance, then appends each campaign's clicks, cost, and conversions to a daily reporting spreadsheet with [Google Sheets](/integrations/google-sheets) Add Rows. The report writes itself before anyone opens the Google Ads dashboard.

Spend Alert

The agent calls Get Campaign Metrics for a key campaign, and when spend or cost-per-click crosses a threshold it posts an alert to the marketing team with [Slack](/integrations/slack) Send Message To Channel. The team hears about a spend spike as it happens, not at month end.

Pause and Notify

The agent detects an underperforming campaign with Search (GAQL), calls Update Campaign Status to pause it, then notifies the account owner with the reason through [Gmail](/integrations/gmail-service) Send Message. The guardrail acts and the owner is told why, in one flow.

Human-in-Loop Highlight

Pausing a campaign stops live spend, and a wrong pause on a high-value campaign costs conversions the moment it takes effect. The judgment of whether an underperformer should actually be paused, or watched one more day, is not one a threshold should own alone. When the agent is about to run Update Campaign Status to pause a campaign above the spend level you set, it treats the change as a [human-in-the-loop](/concepts/human-in-the-loop/) step. It pauses, shows the campaign, its recent spend and conversion trend, and the rule that flagged it, and routes the decision to the account owner through Slack or email. The owner approves, and the agent pauses. The owner holds, and the campaign keeps running. Reporting and metric reads flow through untouched; the change that stops live spend gets a human first.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via Slack

Human decides

Agent resumes with decision

Agent Capabilities

5 actions

Reporting

Search (GAQL) Runs a Google Ads Query Language query against an account, the universal operation for reading any resource, report, or metric. Results contain only the selected resources; monetary fields are returned in micros. Supports pagination via a page token.
List Accessible Customers Lists the Google Ads accounts directly accessible by the connected user, returning both resource names and plain 10-digit customer IDs. To enumerate client accounts under a manager account, use Search (GAQL) with the customer_client resource.
List Campaigns Lists an account's campaigns with their status, channel type, budget, and core performance metrics (clicks, impressions, cost, conversions) for a date range. Monetary values are converted from micros to currency units.
Get Campaign Metrics Retrieves aggregated performance metrics for a single campaign over a date range: clicks, impressions, cost, conversions, click-through rate, and average cost per click.

Campaign Control

Update Campaign Status Enables or pauses a campaign using a partial mutate, leaving all other settings unchanged. Campaign and budget creation is out of scope; create campaigns in the Google Ads UI and manage their status here.

Start building with Google Ads

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us