AI agents for Google Ads

List accessible accounts

Lists the Google Ads accounts the signed-in person can reach directly (not the clients under a manager; use "List client accounts" for those).

Get an account

Reads one Google Ads account by its 10-digit customer ID.

List client accounts

Lists the accounts under a manager account (by the manager's customer ID), one level down by default.

Report on campaigns

Reports each campaign's performance over a date range (a preset like LAST_30_DAYS, or start_date and end_date), optionally only enabled or paused ones, most spend first.

Report on ad groups

Reports each ad group's performance over a date range, optionally in one campaign, most spend first.

Report on keywords

Reports each keyword's performance over a date range, optionally in one campaign, most spend first.

Report on search terms

Reports the searches that triggered the ads over a date range, optionally in one campaign, most clicks first: use it to find terms to add as keywords or negatives.

Run a Google Ads query

Runs any Google Ads Query Language (GAQL) query against an account, for reports the other actions do not cover.

Pause or enable a campaign

Pauses or enables a campaign by its ID (from "Report on campaigns").

Pause or enable an ad group

Pauses or enables an ad group by its ID (from "Report on ad groups").

Change a campaign budget

Sets a campaign budget's daily amount, in the account's currency (like 25.50), by the budget's ID (the number at the end of campaign.campaignBudget in "Report on campaigns").

Add a negative keyword to a campaign

Stops a campaign's ads from showing for searches containing a word or phrase, by campaign ID: match type BROAD (any order), PHRASE (in this order) or EXACT (only this search).