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 |
campaign_id | string or SelectItem | Yes | - | Select the Performance Max campaign |
asset_group_name | string | Yes | - | Name for the asset group |
status | string or SelectableOption | No | {'value': 'PAUSED', 'label': 'Paused'} | Asset group status. Default: PAUSED |
final_url | string | Yes | - | Landing page URL for the asset group |
headlines | array of string | Yes | - | List of headlines (3-15 items, max 30 characters each) |
long_headline | string | Yes | - | Long headline (max 90 characters) |
descriptions | array of string | Yes | - | List of descriptions (2-5 items, max 90 characters each) |
business_name | string | Yes | - | Business name (max 25 characters) |
marketing_images | array of string | No | - | Marketing images. Accepts direct image URLs or Google Drive share links (set to ‘Anyone with the link’). 1.91:1 ratio, min 600x314px. At least one marketing or square marketing image required. |
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 ratio, min 300x300px. At least one marketing or square marketing image required. |
logo_images | array of string | No | - | Square logo images. Accepts direct image URLs or Google Drive share links (set to ‘Anyone with the link’). 1:1 ratio, min 128x128px, recommended 1200x1200px. |
landscape_logo_images | array of string | No | - | Landscape logo images. Accepts direct image URLs or Google Drive share links (set to ‘Anyone with the link’). 4:1 ratio, min 512x128px, recommended 1200x300px. |
youtube_videos | array of string | No | - | YouTube video URLs, including youtube.com or youtu.be links (max 5). |
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. |
tracking_url_template | string | No | - | Tracking template for this asset group’s URLs, for example ‘{lpurl}?utm_source=google&utm_campaign={_campaign}’. Overrides the campaign-level template. |
final_url_suffix | string | No | - | Parameters appended to the landing page URL, for example ‘utm_medium=pmax’. |
url_custom_parameters | array of object or string | No | - | Custom URL parameters as a JSON list of {“key”, “value”} objects, used as {_key} tags in the tracking template or final URL, for example [{“key”: “group”, “value”: “summer”}]. |