شكل هذا العمل واحد دائمًا: القراءة أولًا، والاقتراح ثانيًا، وأن ينظر فيه أحد قبل أن يحدث أي شيء. القراءة هي الوصفة السابقة، وهذه هي الخطوة الثانية.
اقترحه
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 هو السطر الذي يقرؤه الشخص قبل أن يقرر، فاكتبه له لا للسجل.
ماذا يحدث بعد ذلك
- في غرفة المشروع يظهر الاقتراح بطاقةً: ما الذي سيغيّره، كاملًا، وبجانبه تطبيق وتجاوز.
- عبر الواجهة، POST /google-ads/v1/changes/{change_id}/apply مع {"apply": true} يجعله حقيقة، وfalse يُسقطه.
- إن كان الحساب مما يتولّاه متخصصون، تعرض الغرفة البطاقة دون الأزرار: إذ تذهب إلى قائمة انتظارهم، وهم من يطبّقها.
- سمِّ مهمة غرفة المشروع التي يردّ عليها بـ task_id، وتطبيق التغيير يُغلق تلك المهمة.
الإيقاف هو التغيير المفضَّل. الحذف لا يمكن التراجع عنه، أما الإيقاف فيمكن، والاثنان يحققان عادةً الشيء نفسه.
أسئلة شائعة
ماذا لو كانت عملية واحدة في اقتراحي خاطئة؟
يُرفض الاقتراح كله، مع كلمات Google نفسها عن الجزء الذي اعترض عليه. لا يُدوَّن شيء جزئي أبدًا، فالتغيير المعلّق هو دائمًا تغيير سيُنفَّذ كاملًا.
هل يمكنني اقتراح عدة تغييرات دفعة واحدة؟
نعم، حتى خمسين عملية في اقتراح واحد، وتُطبَّق معًا أو لا تُطبَّق إطلاقًا. ومع ذلك اجعل الاقتراح الواحد لقرار واحد: أن يوافق شخص على شيء يستطيع وصفه بجملة هو المقصود من summary.
كم ينتظر الاقتراح؟
ما شاء. لا شيء يُنهي صلاحيته، ولا شيء يطبّقه نيابةً عنك — يبقى معلّقًا في سجل الحساب حتى يطبّقه شخص أو يتجاوزه.