Ad Group Tools
List Google Ads ad groups (the equivalent of Facebook ad sets) with filters.
Ad Group Tools
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
| Prop | Type | Default |
|---|---|---|
customer_id | string | - |
login_customer_id | string | undefined | - |
page_token | string | undefined | - |
resource_names | string[] | undefined | - |
campaign_ids | string[] | undefined | - |
campaign_resource_names | string[] | undefined | - |
ad_group_ids | string[] | undefined | - |
names | string[] | undefined | - |
statuses | string[] | undefined | - |
types | string[] | undefined | - |
cpc_bid_micros | number[] | undefined | - |
cpm_bid_micros | number[] | undefined | - |
cpv_bid_micros | number[] | undefined | - |
target_cpa_micros | number[] | undefined | - |
target_roas | number[] | undefined | - |
effective_target_cpa_micros | number[] | undefined | - |
effective_target_roas | number[] | undefined | - |
limit | number | undefined | - |