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’ |
marketing_images | array of string | No | - | Marketing images. Accepts direct image URLs or Google Drive share links (set to ‘Anyone with the link’). 1-15 items, 1.91:1 aspect ratio, min 600x314px. |
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-15 items combined with marketing_images, 1:1 aspect ratio, min 300x300px. |
logo_images | array of string | No | - | Logo images. Accepts direct image URLs or Google Drive share links (set to ‘Anyone with the link’). Max 5 items combined with square_logo_images, 4:1 aspect ratio, min 512x128px. |
square_logo_images | array of string | No | - | Square logo images. Accepts direct image URLs or Google Drive share links (set to ‘Anyone with the link’). Max 5 items combined with logo_images, 1:1 aspect ratio, min 128x128px. |
headlines | array of string | No | - | List of short headlines (1-5 items, max 30 characters each). Required for single mode. |
long_headline | string | No | - | One long headline (max 90 characters). 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 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, max 30 characters). Use plain text like ‘Learn more’ or ‘Shop now’; no underscores needed. |
youtube_videos | array of string | No | - | List of YouTube video URLs, including youtube.com or youtu.be links (max 5 items). Optional. |
main_color | string | No | - | Main ad color in hex format (e.g., #FF5733). Requires accent_color if set. |
accent_color | string | No | - | Accent color in hex format (e.g., #FFFFFF). Requires main_color if set. |
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’, ‘long_headline’, ‘headlines’ (list of strings, 1-5 items, max 30 chars each), ‘descriptions’ (list of strings, 1-5 items, max 90 chars each), 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’). YouTube video columns accept youtube.com or youtu.be links. Optional columns: ‘marketing_image_2’ to ‘marketing_image_15’, ‘square_marketing_image_2’ to ‘square_marketing_image_15’, ‘logo_image_1’ to ‘logo_image_5’, ‘square_logo_image_1’ to ‘square_logo_image_5’, ‘youtube_video_1’ to ‘youtube_video_5’, ‘call_to_action_text’, ‘main_color’, ‘accent_color’, ‘ad_status’ (defaults to PAUSED if not provided). |