> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate Shareable Previews

> Generate shareable Google Ads preview links for Performance Max asset groups, so a client can see how the ads look without a Google Ads login

Generate shareable Google Ads preview links for Performance Max asset groups, so a client can see how the ads look without a Google Ads login. Google only supports Performance Max asset groups and some YouTube ad formats here; responsive search and display ads are rejected. The links expire, and the expiry comes back with each one.

| | |
| - | - |
| **App** | Google Ads |
| **Operation ID** | `gads_generate_shareable_previews` |
| **Type** | Action |
| **Connection** | `gads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | GadsAccountItem or object or array of object or string or integer | Yes | - | Google Ads account that owns the asset groups. This must be the account the asset groups actually live in, not a manager above it, or Google reports that the asset group does not exist. |
| `preview_type` | enum (`UI_PREVIEW`, `YOUTUBE_LIVE_PREVIEW`) | No | `UI_PREVIEW` | UI\_PREVIEW returns a shareable link to the preview in the Google Ads interface and is what asset groups use. YOUTUBE\_LIVE\_PREVIEW returns YouTube preview links and works only with ad IDs, not asset groups. |
| `asset_group_ids` | string or array of string or integer | No | - | Performance Max asset group IDs to preview, as a list or comma separated. gads\_create\_pmax\_asset\_group returns these, and a report on the asset\_group resource lists existing ones. Use this for UI\_PREVIEW. |
| `ad_ids` | string or array of string | No | - | Ad identifiers to preview, each written as adGroupId~~adId, for example 123456~~789012. Only used with YOUTUBE\_LIVE\_PREVIEW. |

### GadsAccountItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |
| `managerId` | string | Yes | - | The manager ID for the Google Ads account. Ask  user to use the dropdown to select accounts, this manager id is selected background and not shown to the user. |

## Output

**Type**: `List[Dict]`

Returns one row per requested preview with its shareable URL and expiry.

**Fields**: `asset_group_id`, `ad`, `resource_name`, `preview_url`, `youtube_tv_preview_url`, `expires_at`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.