> ## 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`