Manage Google Ads extensions (adsap_google_manage_extension)

Platform: Google Ads · Read or write: Write · Plan: Early Access · Consumes a task: Yes · Preview supported: Yes

What it does

Manages Google Ads extensions: sitelinks, callouts, structured snippets, call, promotion and price. It creates and links new extensions to a campaign in one call, links or unlinks existing ones, or edits an existing asset. Links live at campaign level by default or at account level for every eligible campaign. Ask for a preview before creating.

When to use it

• Use create_and_link to write new extensions and attach them in one call, up to 20 at a time. Each item in extensions carries a type and the fields for that type.
• link and unlink work on assets that already exist. They take links, up to 20 pairs of asset_id and field_type. Find both with adsap_google_list_extensions.
• update_asset needs asset_id, type and at least one field to change. The edit shows everywhere the asset is linked.
• campaign_id is required at the default level, campaign. With level set to account, leave campaign_id out.
• It supports a preview call. Each call is all or nothing: if Google rejects one item, nothing is applied.

Worked example

You ask

“Preview adding the callouts Free shipping and 30-day returns, plus a Sale sitelink, to campaign 21000000001 in Google Ads account 1234567890.”

The assistant calls adsap_google_manage_extension

{
  "ad_account_id": "1234567890",
  "op": "create_and_link",
  "campaign_id": "21000000001",
  "extensions": [
    { "type": "callout", "callout_text": "Free shipping" },
    { "type": "callout", "callout_text": "30-day returns" },
    {
      "type": "sitelink",
      "link_text": "Sale",
      "final_url": "https://www.example.com/sale"
    }
  ],
  "dry_run": true
}

Adsap returns

The field names are the ones Adsap returns. The values are examples.

{
  "ok": true,
  "dry_run": true,
  "platform": "google",
  "action": "assets_mutate",
  "op": "create_and_link",
  "level": "campaign",
  "campaign_id": "21000000001",
  "results": [],
  "count": 3,
  "google_validation": "passed"
}

How to read it

google_validation reads passed because Google checked all three extensions and their campaign links and accepted them. count is the number of extensions in the request. results stays empty in a preview, because nothing was created. level shows where the links would live. If Google rejects the request, ok is false and an error object carries Google’s message.

The response also carries a human_readable_summary sentence, left out of this example. To create the extensions, the assistant repeats the call with dry_run set to false. results then holds one row per extension with its new asset_id.

Parameters

Descriptions are shortened from the tool schema. Your assistant sees the full text.

Example prompts

• “Add four sitelinks to my Search campaign Summer Sale: Shop Men, Shop Women, Sale, Contact.”
• “Add the callouts ‘Free shipping’ and ‘30-day returns’ to every campaign in the account.”
• “Change the promotion extension to 25 percent off and end it on October 31.”
• “Stop the sitelink ‘Sale’ from showing on the Brand campaign.”

Notes

Google Ads assets cannot be deleted, so unlink is how you stop one serving. Assets are account-scoped: editing one changes it everywhere it is linked. Image extension links through the API are gated by Google and fail on most accounts.

Related tools

• adsap_google_create_ad_group: Add an ad group to an EXISTING Google Ads campaign (Search, Display or Demand Gen) in ONE atomic request: the ad group, optional keywords…
• adsap_google_list_extensions: List the extensions (sitelinks, callouts, structured snippets, call, promotion, price, image/AD_IMAGE) linked to Google Ads campaigns AND…
• adsap_google_list_feed_labels: List the distinct Merchant Center feed labels visible to a Google Ads account (from the products synced via its Merchant Center link).

Guide

Read Extensions for the workflow around this tool, and the Tool reference for every tool.

The Google Ads MCP server  page shows how to connect Google Ads to Claude, ChatGPT or Perplexity.