با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
وقتی اسکریپت ها در حالت پیش نمایش اجرا می شوند، هیچ تغییری در داده های کمپین واقعی ایجاد نمی کنند. در عوض، اجرای اسکریپت تغییراتی را نشان می‌دهد که اگر اسکریپت در حال اجرا بود، ایجاد می‌شد . پس از رضایت از خروجی، می توانید اجرای زنده یک اسکریپت را شروع کنید یا آن را زمان بندی کنید.
حالت پیش‌نمایش یک ویژگی قدرتمند است، زیرا به شما امکان می‌دهد یک اسکریپت را بدون نگرانی در مورد تغییرات اشتباه ایجاد شده در داده‌های Google Ads خود توسعه داده و اشکال‌زدایی کنید.
حالت پیش‌نمایش فقط بر تماس‌هایی تأثیر می‌گذارد که از AdsApp به عنوان نقطه ورودی استفاده می‌کنند. تماس با سایر سرویس ها به صورت عادی انجام می شود. به عنوان مثال، اگر یک اسکریپت از MailApp برای ارسال ایمیل استفاده می کند، خواه اسکریپت پیش نمایش یا اجرا شده باشد، ارسال خواهد شد. صفحات گسترده در هر دو سناریو نیز به روز می شوند. یک اسکریپت می تواند از طریق اطلاعات اجرای خود بفهمد که آیا در حالت پیش نمایش اجرا می شود یا خیر.
قطعه زیر در حالت پیش‌نمایش آن‌طور که انتظار می‌رود عمل نمی‌کند:
// Suppose the ad group has no keywords.letadGroup=findAnEmptyAdGroup();// Create a keyword.adGroup.createKeyword("test");// Fetch all keywords in the ad group.letkeywords=adGroup.keywords().get();// In preview mode, will log "false": keyword was not actually created.// In real execution, will log "true".console.log("Are there keywords in the ad group? "+keywords.hasNext());
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003ePreview mode executes scripts without making actual changes to campaign data, allowing for risk-free testing and debugging.\u003c/p\u003e\n"],["\u003cp\u003eIt provides a safe environment to develop and refine Google Ads scripts before applying them to live campaigns.\u003c/p\u003e\n"],["\u003cp\u003eScripts in preview mode can still interact with external services like sending emails or updating spreadsheets.\u003c/p\u003e\n"],["\u003cp\u003eCertain actions, like creating or modifying objects, will not produce the same results in preview mode as in live execution.\u003c/p\u003e\n"],["\u003cp\u003eScripts can determine whether they are running in preview or live mode using execution information.\u003c/p\u003e\n"]]],[],null,["# Preview Mode\n\nWhen scripts are executed in preview mode, they make no changes to the actual\ncampaign data. Instead, script execution shows the changes that **would have**\nbeen made had the script been executing. Once satisfied with the output, you\ncan start the live execution of a script or schedule it.\n\nPreview mode is a powerful feature, as it lets you develop and debug a script\nwithout worrying about erroneous changes being made to your Google Ads data.\n\nPreview mode only affects calls that use `AdsApp` as an entry point. Calls to\nother services will proceed as normal. For example, if a script is using\n`MailApp` to send an email, it will get sent whether or not the script had been\npreviewed or executed. Spreadsheets will get updated in both scenarios as\nwell. A script can find out whether or not it is running in preview mode through\nits [execution info](/google-ads/scripts/docs/concepts/execution-info).\n| **Important:** No objects are created, deleted, or modified during preview. As a consequence, certain code won't execute the same way in preview mode.\n\nThe following snippet won't behave as expected in preview mode: \n\n // Suppose the ad group has no keywords.\n let adGroup = findAnEmptyAdGroup();\n\n // Create a keyword.\n adGroup.createKeyword(\"test\");\n\n // Fetch all keywords in the ad group.\n let keywords = adGroup.keywords().get();\n\n // In preview mode, will log \"false\": keyword was not actually created.\n // In real execution, will log \"true\".\n console.log(\"Are there keywords in the ad group? \" + keywords.hasNext());"]]
