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 |
update_type | string or SelectableOption | Yes | - | Choose whether to create a single ad or multiple ads at once. Available options: ‘single’ (Single Ad), ‘bulk’ (Multiple Ads) |
ad_group_id | string or SelectItem | No | - | Select the ad group for this ad |
ad_status | string or SelectItem | No | - | Select the status for the ad. Available options: ‘ENABLED’, ‘PAUSED’ |
headlines | array of string or object | No | - | List of headlines (3-15 items, max 30 characters each). Each item can be a string or an object with ‘text’ and optional ‘pinned_field’ (HEADLINE_1, HEADLINE_2, HEADLINE_3). Minimum 3 headlines are required. Supports dynamic insertions such as keyword insertion ‘{Keyword:Default}’, location ‘{LOCATION(City):Default}’, and countdown ‘{COUNTDOWN(yyyy-MM-dd HH:mm:ss,days)}’. |
descriptions | array of string or object | No | - | List of descriptions (2-4 items, max 90 characters each). Each item can be a string or an object with ‘text’ and optional ‘pinned_field’ (DESCRIPTION_1, DESCRIPTION_2). Minimum 2 descriptions are required. Supports dynamic insertions such as keyword insertion ‘{Keyword:Default}’, location ‘{LOCATION(City):Default}’, and countdown ‘{COUNTDOWN(yyyy-MM-dd HH:mm:ss,days)}’. |
final_url | string | No | - | The landing page URL where users will go when they click the ad (e.g., https://example.com) |
path_1 | string | No | - | First display path shown in the ad URL (optional, max 15 characters, e.g., ‘products’) |
path_2 | string | No | - | Second display path shown in the ad URL (optional, max 15 characters, e.g., ‘shoes’) |
structured_data | array (also accepts a comma-separated string) | No | - | Use only when update_type is ‘bulk’. CSV/JSON data with required columns: ‘ad_group_id’, ‘final_url’, ‘headlines’ (list of strings or objects with ‘text’ and optional ‘pinned_field’), ‘descriptions’ (list of strings or objects with ‘text’ and optional ‘pinned_field’). Minimum 3 headlines and 2 descriptions required per row. Optional columns: ‘path_1’, ‘path_2’, ‘ad_status’ (defaults to PAUSED if not provided). |
