Read and report tools
The Google Ads reading tools — search over every reportable resource, account discovery, schema lookups, asset links and auto-apply subscriptions. None of them 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.
list_accessible_customers
Read. The Google Ads accounts your Google sign-in can reach. 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?
AdCopilot tools
get_org_context, the call every conversation starts with, and save_org_context, which remembers your business between conversations. Neither counts against your daily operations.
Analysis and audit tools
AdCopilot's eleven read-only analysis tools as of v2.16.0 — full_audit, account_health_score and nine focused lenses. They do the arithmetic on AdCopilot's side and quote the numbers they measured.