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 (must be a Demand Gen ad group) |
ad_status | string or SelectItem | No | - | Select the status for the ad. Available options: ‘ENABLED’, ‘PAUSED’ |
marketing_images | array of string | No | - | Landscape marketing images. Accepts direct image URLs or Google Drive share links (set to ‘Anyone with the link’). 1.91:1 aspect ratio, min 600x314px. At least one marketing image or square marketing image is required. Combined max is 20. |
square_marketing_images | array of string | No | - | Square marketing images. Accepts direct image URLs or Google Drive share links (set to ‘Anyone with the link’). 1:1 aspect ratio, min 300x300px. At least one marketing image or square marketing image is required. Combined max is 20. |
portrait_marketing_images | array of string | No | - | Portrait marketing images. Accepts direct image URLs or Google Drive share links (set to ‘Anyone with the link’). 4:5 aspect ratio, min 480x600px. Optional. Combined with other marketing images, max is 20. |
tall_portrait_marketing_images | array of string | No | - | Tall portrait marketing images. Accepts direct image URLs or Google Drive share links (set to ‘Anyone with the link’). 9:16 aspect ratio, min 600x1067px. Optional. Combined with other marketing images, max is 20. |
logo_images | array of string | No | - | Logo images. Accepts direct image URLs or Google Drive share links (set to ‘Anyone with the link’). 1:1 aspect ratio, min 128x128px. At least 1 required, max 5. |
headlines | array of string | No | - | List of headlines (1-5 items, max 30 characters each). Required for single mode. |
descriptions | array of string | No | - | List of descriptions (1-5 items, max 90 characters each). Required for single mode. |
business_name | string | No | - | Your business/brand name (max 25 characters). Required for single mode. |
final_url | string | No | - | The landing page URL where users will go when they click the ad (e.g., https://example.com) |
call_to_action_text | string | No | - | Call to action button text (optional). Use plain text like ‘Learn more’ or ‘Shop now’; no underscores needed. |
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’, ‘business_name’, ‘headline_1’, ‘description_1’, ‘logo_image_1’, and at least one of ‘marketing_image_1’ or ‘square_marketing_image_1’. Image columns accept direct image URLs or Google Drive share links (set to ‘Anyone with the link’). Optional columns: ‘marketing_image_2’ to ‘marketing_image_20’, ‘square_marketing_image_2’ to ‘square_marketing_image_20’, ‘portrait_marketing_image_1’ to ‘portrait_marketing_image_20’, ‘tall_portrait_marketing_image_1’ to ‘tall_portrait_marketing_image_20’, ‘logo_image_2’ to ‘logo_image_5’, ‘headline_2’ to ‘headline_5’, ‘description_2’ to ‘description_5’, ‘call_to_action_text’, ‘ad_status’ (defaults to PAUSED if not provided). |
