The shape of this work is always the same: read first, propose second, and let somebody look at it before anything happens. The reading is the previous recipe; this is the second step.
Propose it
curl -sX POST https://top-rated.team/google-ads/v1/accounts/1234567890/changes \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "Content-Type: application/json" \
-d '{
"summary": "Pause the Brand campaign: CTR under 1% for three weeks",
"operations": [
{
"campaignOperation": {
"update": {
"resourceName": "customers/1234567890/campaigns/987654321",
"status": "PAUSED"
},
"updateMask": "status"
}
}
]
}'
It answers a change_id. Google has validated every operation by then, so a proposal that comes back is one that would run — but the account is exactly as it was. The summary is the line a person reads before deciding, so write it for them and not for a log.
What happens next
- In a project room the proposal appears as a card: what it would change, in full, with Apply and Skip beside it.
- Through the API, POST /google-ads/v1/changes/{change_id}/apply with {"apply": true} makes it real, and false drops it.
- If the account is one specialists look after, the room shows the card without the buttons: it goes to their queue instead, and they apply it.
- Name the project room task it answers with task_id, and applying the change closes that task.
Pausing is the change to prefer. Removing something cannot be put back; pausing can, and the two usually buy you the same thing.
Questions people ask
What if one operation in my proposal is wrong?
The whole proposal is refused, with Google's own words about which part it objected to. Nothing partial is ever written down, so a pending change is always one that would run in full.
Can I propose several changes at once?
Yes, up to fifty operations in one proposal, and they are applied together or not at all. Keep one proposal to one decision anyway: a person approving a thing they can describe in a sentence is the point of the summary.
How long does a proposal wait?
As long as it takes. Nothing expires it, and nothing applies it on your behalf — it sits pending in the account's record until a person applies it or skips it.