Inputs
GadsAccountItem
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_atDocumentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
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
| App | Google Ads |
| Operation ID | gads_generate_shareable_previews |
| Type | Action |
| Connection | gads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| 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 |
| 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. |
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