Форма этой работы всегда одна: сначала читать, потом предлагать и дать кому-то посмотреть, прежде чем что-либо произойдёт. Чтение — это предыдущий рецепт, а это — второй шаг.
Предложите
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.
Сколько предложение ждёт?
Сколько потребуется. Ничто не отменяет его по сроку, и ничто не применяет его за вас — оно остаётся ожидающим в истории аккаунта, пока человек не применит его или не пропустит.