خطاها و هشدارها

اسکریپت‌های گوگل ادز به روش «بهترین تلاش» اجرا می‌شوند: آن‌ها تلاش می‌کنند تغییراتی در داده‌های گوگل ادز ایجاد کنند، اما اگر تغییر خاصی موفقیت‌آمیز نباشد، اسکریپت آن را در گزارش تغییرات ثبت می‌کند و به اجرا ادامه می‌دهد:

// 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 معنادار تولید کند زیرا محدوده تاریخ مشخص نشده است. بنابراین اجرای اسکریپت متوقف می‌شود و یک پیام خطا در لاگ‌های متنی ثبت می‌شود.

نکته کلیدی: وقتی اسکریپت‌های گوگل ادز با موفقیت یک شیء را برمی‌گردانند، کار با آن ایمن است. اگر دریافت یک شیء با شکست مواجه شود، خطایی رخ می‌دهد.

اگر سهمیه‌ها از حد مجاز فراتر بروند، اسکریپت هشدارهایی را ثبت می‌کند. اجرای اسکریپت همچنان ادامه خواهد یافت، اما شما همیشه باید هشدارها را بررسی کنید.

در گزارش‌های اجرا، خطاها با رنگ قرمز و هشدارها با رنگ نارنجی نمایش داده می‌شوند. همچنین می‌توانید پیام‌های سفارشی را برای عیب‌یابی و نظارت، به این گزارش‌ها ارسال کنید .