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

# Edit Responsive Search Ad

> Edit existing responsive search ads (RSA) — update headlines, descriptions, final URL, or display paths

Edit existing responsive search ads (RSA) — update headlines, descriptions, final URL, or display paths. Only provided fields are changed; omitted fields keep their existing values.

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