| App | Google Ads |
| Operation ID | gads_edit_responsive_search_ad |
| Type | Action |
| Connection | gads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| Requires approval | Yes (write operation) |
Inputs
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
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 |
update_type | string or SelectableOption | Yes | - | Choose whether to edit a single ad or multiple ads at once. Available options: ‘single’ (Single Ad), ‘bulk’ (Multiple Ads) |
ad_id | string or SelectItem | No | - | The ID of the responsive search ad to edit |
headlines | array of string or object | No | - | New list of headlines (3-15 items, max 30 characters each). Each item can be a string or an object with ‘text’ and optional ‘pinned_field’ (HEADLINE_1, HEADLINE_2, HEADLINE_3). If not provided, existing headlines are kept. |
descriptions | array of string or object | No | - | New list of descriptions (2-4 items, max 90 characters each). Each item can be a string or an object with ‘text’ and optional ‘pinned_field’ (DESCRIPTION_1, DESCRIPTION_2). If not provided, existing descriptions are kept. |
final_url | string | No | - | New landing page URL (e.g., https://example.com). If not provided, existing URL is kept. |
path_1 | string | No | - | New first display path shown in the ad URL (max 15 characters). If not provided, existing path is kept. |
path_2 | string | No | - | New second display path shown in the ad URL (max 15 characters). If not provided, existing path is kept. |
structured_data | array (also accepts a comma-separated string) | No | - | Use only when update_type is ‘bulk’. CSV/JSON data with required column: ‘ad_id’. Optional columns: ‘headlines’ (list), ‘descriptions’ (list), ‘final_url’, ‘path_1’, ‘path_2’. Only provided fields will be updated; omitted fields keep their existing values. |
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. |
SelectItem
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | The value of the selectable item. |
label | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |
SelectableOption
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
Output
Type:Dict
Returns updated ads details.
Fields: updated_ads, updated_count
