account | GadsAccountItem or object or array of object or string or integer | Yes | - | Select the Google Ads account, ask user for it if not provided |
campaign | string or SelectItem | Yes | - | Select the campaign to create the ad group in |
ad_group_name | string | Yes | - | Name for the ad group |
ad_group_type | string or SelectableOption | Yes | - | Ad group type. Available: ‘SEARCH_STANDARD’, ‘DISPLAY_STANDARD’, ‘SEARCH_DYNAMIC_ADS’, ‘DEMAND_GEN’, ‘SHOPPING_PRODUCT_ADS’, ‘APP’. Note: for SHOPPING_PRODUCT_ADS, the ad group is automatically created with a default ‘All products’ listing group (targets every product in the linked Merchant Center feed) and a default Shopping product ad so it is ready to serve. Use ‘APP’ for ad groups inside App campaigns. |
status | string or SelectableOption | No | {'value': 'PAUSED', 'label': 'Paused'} | Ad group status. Default: PAUSED (recommended) |
cpc_bid | number | No | - | CPC bid as an actual dollar value in the account currency, NOT in micros (e.g. pass 1.5 for $1.50). Do not multiply by 1,000,000 — the backend converts to micros automatically. Required for Manual CPC campaigns, ignored for automated bidding. |
disable_search_term_matching | boolean | No | - | Disable AI Max search term matching for this ad group (search ad groups only). Only meaningful when the parent campaign has AI Max enabled — search term matching is on by default there. |
locations | array of string or SelectableOption | No | - | Target countries for the ad group (Demand Gen only). Use 2-letter ISO country codes (e.g., ‘US’, ‘CA’, ‘GB’) |
languages | array of string or SelectableOption | No | - | Target languages for the ad group (Demand Gen only). Use 2-letter language codes (e.g., ‘EN’ for English). Default: All Languages. |
channel_targeting | array of string or SelectableOption | No | - | Channel targeting for Demand Gen ad groups. Available: ‘GMAIL’, ‘DISCOVER’, ‘DISPLAY’, ‘YOUTUBE_IN_FEED’, ‘YOUTUBE_IN_STREAM’, ‘YOUTUBE_SHORTS’. Default: All Google channels (excluding Display) |
user_list | array of string | No | - | Audiences to target for App engagement ad groups. Accepts UserList IDs (e.g., ‘987654321’) or full resource names (e.g., ‘customers/123/userLists/987654321’). Required by Google for App engagement (APP_CAMPAIGN_FOR_ENGAGEMENT) campaigns; leave empty for other App campaign types. |
target_cpa | number | No | - | Ad-group-level target CPA override in the account currency (e.g., 25 for $25), NOT in micros. Only honored for App engagement (APP_CAMPAIGN_FOR_ENGAGEMENT) ad groups; ignored otherwise. |
