这项工作的形态始终相同:先读取,再提出,在任何事发生之前让有人看一看。读取是上一个做法,这是第二步。
提出它
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"
}
}
]
}'
它会返回一个 change_id。到那时 Google 已校验过每一项操作,所以返回的提案就是会执行的提案 — 但账户仍和原来完全一样。summary 是人在决定之前读的那一行,所以要写给他们看,而不是写给日志。
接下来会发生什么
- 在项目房间里,提案以卡片的形式出现:它会更改什么,完整列出,旁边有“应用”和“跳过”。
- 通过 API,POST /google-ads/v1/changes/{change_id}/apply 并带上 {"apply": true},就会让它生效,false 则丢弃它。
- 如果账户由专家照看,房间里显示的是没有按钮的卡片:它转而进入专家的队列,由他们来应用。
- 用 task_id 指明它所回应的项目房间任务,应用这项更改时就会关闭那个任务。
优先选暂停。删除的东西无法撤销,暂停可以,而两者通常能达到同样的效果。
常见问题
如果提案里有一项操作是错的呢?
整个提案都会被拒绝,并附上 Google 自己说明它反对哪一部分的话。从不会记录下部分内容,所以待处理的更改一定是会完整执行的更改。
可以一次提出多项更改吗?
可以,一个提案最多五十项操作,它们要么一起应用,要么都不应用。不过还是让一个提案对应一个决定:让人批准一件他们能用一句话说清的事,正是 summary 的用意。
提案会等多久?
要等多久都行。没有东西会让它过期,也没有东西会替你应用它 — 它会一直以待处理状态留在账户的记录里,直到有人应用或跳过它。