Draft ad groups with AI (async)
draft_ad_groupsRead-only
Starts an AI draft of ad groups for an existing Search campaign and returns draft_id at once; it changes nothing in Google Ads. ADM reads the landing page, groups the keywords by theme and writes responsive search ads per group. Poll get_ad_group_draft every poll_after_seconds (usually done in 1-3 minutes). The finished ad_groups can be passed verbatim to add_ad_groups (preview first). Needs a read_write key and a paid plan. Each call runs several AI calls: do not repeat it for the same input while a draft is pending or running.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | Yes | 1-200 keywords in Google notation: broad (text), "phrase", [exact]. | |
| language | Yes | Ad language code, e.g. en, de, ja. Also added as the language tag of each ad group name. | |
| campaign_id | Yes | Campaign id from get_campaigns (must be a SEARCH campaign). | |
| customer_id | Yes | Google Ads customer ID from get_accounts, e.g. 123-456-7890. | |
| ads_per_group | No | Responsive search ads per ad group, 1-3. Default 1. | |
| paused_keywords | No | Optional keywords to add PAUSED, same notation. Passed through to the primary ad group without AI. | |
| landing_page_url | Yes | Landing page URL (absolute http/https). Its content drives grouping and ad text; it is also the ads' final_url. | |
| group_name_prefix | No | Optional prefix for every ad group name, e.g. "remove-watermark/" (max 100 characters). |