この仕事の形はいつも同じです。先に読み、次に提案し、何かが起きる前に誰かが目を通す。読むのは前のレシピで、これは 2 つめのステップです。
提案する
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 は、人が判断する前に読む 1 行なので、ログのためではなく、その人のために書いてください。
そのあとどうなるか
- プロジェクトルームでは、提案はカードとして現れます。何をどう変更するかがすべて示され、そのそばに「適用」と「スキップ」があります。
- API では、POST /google-ads/v1/changes/{change_id}/apply に {"apply": true} を送ると実行され、false なら破棄されます。
- 専門家が見ているアカウントなら、ルームにはボタンのないカードが表示されます。提案は専門家のキューに入り、専門家が適用します。
- 答える対象のプロジェクトルームのタスクを task_id で指定すると、変更を適用したときにそのタスクが閉じます。
選ぶなら停止です。削除したものは元に戻せませんが、停止なら戻せます。そして多くの場合、2 つで得られるものは同じです。
よくある質問
提案の中の操作が 1 つ間違っていたら？
提案全体が拒否され、どの部分に異議があるかについての Google 自身の言葉が付きます。一部だけが書き留められることはないので、保留中の変更は常に、全部が実行されるものです。
複数の変更を一度に提案できますか？
はい、ひとつの提案に最大 50 の操作を入れられ、まとめて適用されるか、まったく適用されないかです。それでも、ひとつの提案はひとつの判断にとどめてください。ひとことで説明できるものを人が承認する、というのが summary の意味です。
提案はどのくらい待ちますか？
必要なだけです。期限切れになることはなく、あなたに代わって誰かが適用することもありません。人が適用するかスキップするまで、アカウントの記録の中で保留中のままです。