API Reference

Google Ads / API Reference

gads_update_rsa

Google Ads tool (extended/low-level coverage). For common tasks prefer the RECOMMENDED google_ads_* actions; use these only for advanced operations those don't cover. Replace headlines and/or descriptions of an existing Responsive Search Ad (RSA). Replaces the entire headlines or descriptions list. To add a single asset without removing existing ones, use gads_add_rsa_asset instead. Args: ad_id: ID of the ad to update (required). ad_group_id: Ad group ID that contains the ad (required). headlines: New list of headline strings (3–15 items, max 30 chars each). Replaces all existing headlines. descriptions: New list of description strings (2–4 items, max 90 chars each). Replaces all existing descriptions. customer_id: Google Ads customer ID. Leave blank to use default.

This is a write tool: it updates rsa in your Google Ads account. Claude asks you to confirm before it runs.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Update rsa in my Google Ads account for [ad id], [ad group id].

It takes 2 required and 3 optional parameters.

Parameters

ParameterTypeRequiredDescription
ad_idstringYesAd Id
ad_group_idstringYesAd Group Id
headlinesarrayNoHeadlines
descriptionsarrayNoDescriptions
customer_idstringNoCustomer Id

Related Google Ads tools

Before you can call it

This tool needs a connected Google Ads account. The Google Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads