ads_query
Run read-only GAQL queries against a Google Ads account to retrieve campaign and metrics data, with _micros money fields returned in currency units.
Instructions
Run any read-only GAQL query against a Google Ads account (e.g. SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS). Money fields ending in _micros are returned in currency units.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"customerId": "<customerId>",
"query": "<query>"
},
"name": "ads_query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes | ||
| customerId | Yes | Google Ads customer ID (with or without dashes) | |
| loginCustomerId | No | Manager (MCC) ID if accessing through a manager; defaults to ads.json |