Tools for listing Google Ads ad groups under a customer.
Ad groups = ad sets
In Google Ads, an ad group is the structural equivalent of a Facebook ad set. It groups ads under a campaign and holds bid settings (CPC/CPM/CPV, target CPA, target ROAS).
list_ad_groups
List Google Ads ad groups for a customer. Returns each ad group's ID, name, status, type, parent campaign ID, and bid settings (CPC/CPM/CPV micros, target CPA micros, target ROAS).
Filters compose through optional list parameters. Combine them to narrow the result set.
Parameters
| Parameter | Type | Description |
|---|---|---|
customer_id |
string |
Google Ads customer ID. Accepts dashed (123-456-7890) or digits-only (1234567890) format. Required. |
login_customer_id |
string | undefined |
Manager (MCC) customer ID for the login-customer-id header. |
page_token |
string | undefined |
Pagination token from a previous response. |
resource_names |
string[] | undefined |
Optional ad group resource names to filter by. |
campaign_ids |
string[] | undefined |
Optional parent campaign IDs to filter by. |
campaign_resource_names |
string[] | undefined |
Optional parent campaign resource names to filter by. |
ad_group_ids |
string[] | undefined |
Optional ad group IDs to filter by. |
names |
string[] | undefined |
Optional ad group names to filter by. |
statuses |
string[] | undefined |
Optional status filter: "ENABLED", "PAUSED", "REMOVED". Defaults to excluding removed ad groups. |
types |
string[] | undefined |
Optional ad group type filter (e.g., "SEARCH_STANDARD", "DISPLAY_STANDARD", "VIDEO_BUMPER"). |
cpc_bid_micros |
number[] | undefined |
Optional exact-match CPC bid filter (in micros). |
cpm_bid_micros |
number[] | undefined |
Optional exact-match CPM bid filter (in micros). |
cpv_bid_micros |
number[] | undefined |
Optional exact-match CPV bid filter (in micros). |
target_cpa_micros |
number[] | undefined |
Optional exact-match target CPA filter (in micros). |
target_roas |
number[] | undefined |
Optional exact-match target ROAS filter. |
effective_target_cpa_micros |
number[] | undefined |
Optional exact-match effective target CPA filter (in micros). |
effective_target_roas |
number[] | undefined |
Optional exact-match effective target ROAS filter. |
limit |
number | undefined |
Optional upper bound on rows returned. |
Example
Natural Language
List all enabled ad groups in campaign 22334455
Show me ad groups in customer 123-456-7890 with target ROAS set
Direct Query
{
"tool": "list_ad_groups",
"arguments": {
"customer_id": "123-456-7890",
"campaign_ids": ["22334455"],
"statuses": ["ENABLED"]
}
}
Related
- list_ads List ads inside an ad group
- get_insights View ad-group-level performance metrics