Draft Performance Max asset changes
draft_asset_group_assetsDraft additions or removals of Performance Max asset group assets, returning a preview with asset counts before any change is confirmed and applied.
Instructions
Draft adding and/or removing assets of a Performance Max asset group — returns a PREVIEW.
Adds new text, image and YouTube assets and unlinks existing ones in one atomic request, so an asset is replaced without the group dropping below Google's minimums (3 headlines, 1 long headline, 2 descriptions, one of them at most 60 characters). Texts already in the group are skipped. Images are checked and sorted by aspect ratio; removed assets stay in the account's asset library. The preview lists the asset counts per type after the change. Nothing changes until confirm_and_apply applies the plan_id; a dry run has Google validate it.
Google Ads API: https://developers.google.com/google-ads/api/docs/start
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| images | No | Images to add, each {"url": "..."} or {"upload_id": "up_..."} with an optional "role": "marketing" (default; landscape 1.91:1, square 1:1 or portrait 4:5 by aspect ratio), "logo" (1:1) or "landscape_logo" (4:1). PNG, JPEG or GIF up to 5120 KB. | |
| headlines | No | Headlines to add, at most 30 characters each (up to 15 in the group). | |
| customer_id | No | Google Ads customer ID (digits, dashes optional). Defaults to the configured account. | |
| descriptions | No | Descriptions to add, at most 90 characters (up to 5). | |
| business_name | No | Business name to add, at most 25 characters (one per group). | |
| asset_group_id | Yes | Numeric asset group id (from get_pmax_performance or get_pmax_assets). | |
| long_headlines | No | Long headlines to add, at most 90 characters (up to 5). | |
| remove_asset_ids | No | Asset ids to unlink from the group (from get_pmax_assets). | |
| youtube_video_ids | No | YouTube video ids to add (the 11 characters after "v=" in the URL), up to 5 per group. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||