الأخطاء والتحذيرات

يتم تنفيذ نصوص "إعلانات Google" البرمجية بأفضل جهد: فهي تحاول إجراء تغييرات على بيانات "إعلانات Google"، ولكن إذا لم ينجح تغيير معيّن، سيسجِّله النص البرمجي في سجلّ التغييرات ويتابع التنفيذ:

// Attempt an invalid change.
let amount = 999999999999;
campaign.getBudget().setAmount(amount);
// Error is logged into Changes log, but the script keeps running.

// Suppose we must know whether the change actually happened.
if (campaign.getBudget() != amount) {
  // The current value of budget is not the one we expected.
  // The change must have failed.
}

تتضمن العمليات التي تنتج أخطاءً مماثلة ما يلي:

• ضبط عرض سعر كلمة رئيسية أكبر من ميزانية الحملة.
• ضبط اسم حملة على اسم حالي
• إنشاء مجموعة إعلانية في حملة وصلت بالفعل إلى حصتها المخصصة للمجموعات الإعلانية.

ومع ذلك، لا يمكن تجاهل بعض الأخطاء. يُرجى الاطّلاع على المثال أدناه:

let keywords = AdsApp.keywords()
    .withCondition("metrics.clicks > 10")
    // Forgot forDateRange().
    .get();

باستخدام هذا الرمز، لا يمكن أن ينتج عن النص البرمجي مكرّر keywords مهم بسبب عدم تحديد النطاق الزمني. وبالتالي سيتوقف تنفيذ النص البرمجي، وسيتم تسجيل رسالة خطأ في السجلات النصية.

نقطة رئيسية: عندما تُرجع نصوص "إعلانات Google" البرمجية أحد العناصر بنجاح، يمكنك التعامل معها بأمان. قد يحدث خطأ في حال تعذّر استرجاع أحد العناصر.

ويتم تسجيل التحذيرات بواسطة النص البرمجي في حال تجاوز quotas. سيستمر تنفيذ النص البرمجي، ولكن يجب عليك دائمًا مراجعة التحذيرات.

تظهر الأخطاء باللون الأحمر والتحذيرات باللون البرتقالي في سجلات التنفيذ. يمكنك أيضًا إرسال رسائل مخصّصة إلى هذه السجلات لأغراض تحديد المشاكل وحلّها والمراقبة.