Plan: pause Google Ads entities
gads_plan_pause_entitiesPlan pausing Google Ads campaigns, ad groups, or ads before applying changes: validates IDs, captures current status for rollback, and returns a dry-run diff with risks and a confirmation token.
Instructions
Plan pausing Google Ads campaigns, ad groups or ads (status PAUSED, nothing else). Each entity is read first (current status kept for the rollback) and dry-run by Google (validateOnly). Ad ids are "<ad_group_id>~<ad_id>". Returns the plan (diff, risks, confirmation_token, confirm): show it to the user, then gads_apply. A paused entity stops spending; rollback_plan re-enables it only if allow_activate is set.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"level": "<level>",
"ids": "<ids>"
},
"name": "gads_plan_pause_entities"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | Ids to pause (1 to 25): campaign ids, ad group ids, or '<ad_group_id>~<ad_id>' for ads | |
| level | Yes | What to pause | |
| client_id | No | Client id from clients_list; empty uses the only client | |
| customer_id | No | Google Ads customer id (10 digits, dashes allowed); empty uses the client's own customer |