Google Ads / API Reference
gads_run_custom_report
Google Ads tool (extended/low-level coverage). For common tasks prefer the RECOMMENDED google_ads_* actions; use these only for advanced operations those don't cover. Run an arbitrary GAQL query and return its rows. The escape hatch for anything the named tools do not cover. GAQL is a read-only language -- no GAQL statement changes an account -- so this cannot mutate anything regardless of what is passed. Args: gaql_query: A full GAQL query, e.g. "SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS".
This is a read-only tool: it returns run custom report for your Google Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Run custom report in my Google Ads account for [gaql query].
It takes 1 required and 1 optional parameter.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
gaql_query | string | Yes | Gaql Query |
customer_id | string | No | Customer Id |
Related Google Ads tools
gads_run_offline_user_data_jobgads_account_overviewgads_ad_performancegads_add_ad_group_age_rangegads_add_ad_group_carriergads_add_ad_group_gender
Before you can call it
This tool needs a connected Google Ads account. The Google Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account:
- Google Ads — Audits & Health
- Google Ads — Keywords
- Google Ads — Negative Keywords
- Google Ads — Bids & Budgets
Start free — 30 tool calls a month
No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.