Google Ads / API Reference
google_ads_add_to_shared_negative_list
Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Add keywords to an existing shared negative keyword list. Args: customer_id: Google Ads customer ID. shared_set_id: ID of the shared negative keyword list. keywords_json: JSON array of objects with 'text' and 'match_type'. Example: '[{"text": "free", "match_type": "EXACT"}, {"text": "cheap", "match_type": "BROAD"}]'
This is a write tool: it adds to shared negative list 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:
Add to shared negative list in my Google Ads account for [shared set id], [keywords json].
It takes 3 required and 0 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | Yes | Customer Id |
shared_set_id | string | Yes | Shared Set Id |
keywords_json | string | Yes | Keywords Json |
Related Google Ads tools
google_ads_add_adgroup_negative_keywordsgoogle_ads_add_audience_to_campaigngoogle_ads_add_keywordsgoogle_ads_add_location_targetgoogle_ads_add_negative_keywordsgoogle_ads_add_placement_exclusion
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: