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