google ads get adgroups
google_ads_get_adgroupsRetrieve ad groups for a Google Ads account by customer ID, with optional campaign or status filters, to analyze campaign structure.
Instructions
List ad groups for a Google Ads account, optionally filtered by campaign.
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>"
},
"name": "google_ads_get_adgroups"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. | |
| campaignId | No | Filter by campaign ID | |
| customerId | Yes | Google Ads customer ID (without dashes, e.g., 1234567890) | |
| statusFilter | No | Native status values used to filter the returned entities. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Original tool result: parsed JSON when the text is JSON, otherwise the text or multiple MCP content blocks. Provider fields depend on the selected query. |