Read and report tools
The Google Ads reading tools, from search over any reportable resource to recommendations, audiences and keyword research. None changes anything.
These tools only read. They run without a proposal because they never change anything. See Read vs write.
search
Read. Any Google Ads report, in Google's query language (GAQL): campaigns, ad groups, keywords, search terms, metrics, policy status, change history and more.
Show me last month's spend and conversions by campaign.
You never write the date range into the query. Pass start_date and end_date
as YYYY-MM-DD and AdCopilot adds the correctly quoted segments.date filter:
resource:campaignfields:campaign.name,metrics.cost_micros,metrics.conversionsstart_date:2026-08-01end_date:2026-08-31orderings:metrics.cost_micros DESC
which reaches Google as:
SELECT campaign.name, metrics.cost_micros, metrics.conversions
FROM campaign
WHERE segments.date BETWEEN '2026-08-01' AND '2026-08-31'
ORDER BY metrics.cost_micros DESCThe two dates take YYYY-MM-DD only, not shortcut tokens. Anything
hand-written into conditions is passed through untouched, which is the usual
source of date syntax errors, so send the two dates instead.
Money comes back in micros: cost_micros ÷ 1,000,000 is the amount in the
account's currency.
performance_report
Read. A performance table at one level: the account, its campaigns, ad groups, ads, keywords, search terms or portfolio bid strategies, with Google's standard columns: impressions, clicks, cost and conversions, plus each level's own (all conversions, first-page and first-position bid estimates, search-term match type, average CPC). Money comes back in the account's currency, not in micros. With no dates it reads the last 30 days, the top 25 rows by cost.
Show me last month's keywords in the Brand campaign by cost.
level:keywordcampaign_id: the campaign's idstart_date:2026-10-01end_date:2026-10-31
list_accessible_customers
Read. The Google Ads accounts your Google sign-in can reach, and those shared with you through a teammate's login. Not counted against your daily operations. See Accounts and scope.
Which Google Ads accounts can I act on?
get_resource_metadata
Read. The fields you can select, filter and sort on for a resource, so the assistant builds a correct query instead of guessing a field name. Not counted against your daily operations.
What fields can I query on the search term view?
list_asset_links
Read. Every asset link in the account, at account, campaign and ad group level: which phone numbers, sitelinks and callouts are on, where, whether Google is serving them, and the call that pauses or re-enables each.
Which phone numbers are on my ads, and where?
list_auto_apply_subscriptions
Read. The recommendation types Google is allowed to apply to the account without asking. The Google Ads API covers only some of them; the rest are named as visible only in the Google Ads interface, so this list alone never proves auto-apply is fully off.
Is Google auto-applying any recommendations on my account?
list_recommendations
Read. The account's open Google Ads Recommendations. Each comes with Google's description of its type, the settings it would change (current and proposed values), Google's own estimate of its effect when Google gives one, and how the change is made: an AdCopilot tool with its arguments filled in, proposed to you like any other change, or the Recommendations page in Google Ads. It applies and dismisses nothing. Google can replace or withdraw a recommendation within the day, so it is listed again before acting. On Free it counts 2 operations toward the daily limit (see Analysis and audit tools).
What is Google recommending for my account, and which of it should I do?
list_audiences
Read. The account's audience lists (open or closed, size range, Search and Display eligibility, match rate for customer lists), its custom and combined audiences, and for each enabled or paused campaign its audience setting (Observation, Targeting or not set) and the audiences attached to the campaign or its ad groups, with clicks, conversions and cost. In-market and affinity segments are listed only when you search them by name. On Free it counts 2 operations toward the daily limit (see Analysis and audit tools).
Which audiences are on my campaigns, and how are they doing?
get_keyword_ideas
Read. New keyword ideas from Google's Keyword Planner, grown from up to 20 words you give, a page of your site, or the whole site. Each idea comes with Google's estimate of how often it is searched a month (over the last 12 months), its competition (low, medium or high) and the range advertisers have paid to show at the top of the page. These are Google's estimates, not a promise of what an ad will get: a word searched too rarely shows no figure, and a new account, or one that has never spent, can get ranges or no ideas at all. One call returns one page, 50 ideas by default and at most 200; the next page is another call, made only when you ask for it. It creates and saves nothing.
Find keyword ideas for a plumbing business in Bangalore, with how often each is searched.
get_keyword_metrics
Read. Google's estimate of how often each keyword is searched a month, its competition and its top-of-page bid range, for keywords exactly as you write them: the ones the account already runs, or a list you name. Up to 1,000 keywords a call, or 200 with the month-by-month trend; a longer list is refused, never cut short. Google counts near-identical words (plurals, spellings) under one row, and the answer says which were counted together. The figures describe past searches, not what an ad will get.
How often are my top ten keywords searched each month, and what does the top of the page cost?
get_keyword_forecast
Read. Google's forecast of the clicks, impressions and cost a set of keywords would bring at a bid or a daily budget, simulated for this account over the 30 days starting two days from now, or dates you give within a year. Manual CPC needs a most-per-click bid; Maximize clicks and Maximize conversions need a daily budget. A figure Google does not forecast is listed as unavailable, with the reason, never shown as zero. It is Google's estimate, not a promise, and a new account, or one that has never spent, gets rougher figures or none. It creates no campaign and saves no keyword plan.
If I bid $2 a click on these keywords, roughly how many clicks and how much spend would a month bring?
Google answers keyword research about once a second per Google Ads account, so AdCopilot sends exactly one request per call and never repeats one. One call carries many keywords: ask for a whole list at once rather than word by word.
AdCopilot tools
The two calls every conversation uses, get_org_context to start and save_org_context to remember your business. Neither counts against your daily operations.
Analysis and audit tools
The read-only analysis tools, from the full audit and account health score to change history and conversion-gap lenses. They quote what they measured.