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 |
ad_group_id | string or SelectItem | Yes | - | 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’ |
ad_name | string | No | - | Optional name for the ad. If not provided, a name will be generated automatically. |
videos | array of string | Yes | - | List of YouTube video URLs, including youtube.com or youtu.be links (1-5). Required. |
logo_images | array of string | Yes | - | 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. |
companion_banners | array of string | No | - | Optional companion banner image. Accepts a direct image URL or Google Drive share link (set to ‘Anyone with the link’). Single value supported by Google Ads. |
headlines | array of string | Yes | - | List of short headlines (1-5 items, max 30 characters each). |
long_headlines | array of string | No | - | Optional list of long headlines (0-5 items, max 90 characters each). |
descriptions | array of string | Yes | - | List of descriptions (1-5 items, max 90 characters each). |
business_name | string | Yes | - | Your business/brand name (max 25 characters). |
final_url | string | Yes | - | The landing page URL where users will go when they click the ad (e.g., https://example.com) |
breadcrumb1 | string | No | - | Path 1: First part of text that appears in the ad with the displayed URL (optional). |
breadcrumb2 | string | No | - | Path 2: Second part of text that appears in the ad with the displayed URL (optional). |
call_to_action | string or SelectableOption | No | - | Call to action type (e.g., SHOP_NOW, LEARN_MORE, SIGN_UP). If not set, Google will automatically select the optimal CTA. |
inventory_preferences | array of string or SelectableOption | No | - | Choose which YouTube ad formats to prefer when serving the videos. Available: ‘IN_STREAM’, ‘IN_FEED’, ‘SHORTS’. Default: no preference (Google serves on all formats). |