معلومات التنفيذ
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
معلومات حول نص برمجي قيد التشغيل
يمكنك الوصول إلى سمات معيّنة لنص برمجي قيد التشغيل من خلال طرق الكائن
ExecutionInfo. على سبيل المثال،
isPreview()
تخبرك ما إذا كان يتم حاليًا عرض معاينة لبرنامج نصي أو ما إذا كان يتم تنفيذه فعليًا.
يؤدي ذلك غالبًا إلى تبسيط عملية تصحيح الأخطاء في الرمز البرمجي:
// Code that generates a report.
// ...
if (!AdsApp.getExecutionInfo().isPreview()) {
// Do not email the report when in preview mode!
MailApp.sendEmail("customer@example.com", "Report is ready!", report);
}
معلومات عن حساب نص برمجي
غالبًا ما تكون معلومات الحساب مطلوبة لتشغيل نص برمجي، خاصةً عند استخدام النص البرمجي نفسه بدون تغيير في حسابات متعددة. إذا كان النص البرمجي يرسل تقريرًا عبر البريد الإلكتروني، على المستلِم تحديد الحساب المصدر. يمكنك استخدام طريقة getCustomerId() الخاصة بالكائن Account لهذا الغرض:
let accountId = AdsApp.currentAccount().getCustomerId();
MailApp.sendEmail("customer@example.com",
"Report is ready for " + accountId, report);
يحتوي العنصر Account أيضًا على طرق تتيح لك تحديد عملة الحساب ومنطقته الزمنية.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eAccess attributes of a running script using the \u003ccode\u003eExecutionInfo\u003c/code\u003e object, such as determining if the script is in preview mode with \u003ccode\u003eisPreview()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUtilize the \u003ccode\u003eAccount\u003c/code\u003e object to retrieve account information like customer ID (\u003ccode\u003egetCustomerId()\u003c/code\u003e), currency, and time zone, particularly useful when a single script operates across multiple accounts.\u003c/p\u003e\n"],["\u003cp\u003eSimplify debugging and reporting by conditionally executing code based on the script's execution mode and including account-specific details in outputs like emails.\u003c/p\u003e\n"]]],[],null,["# Execution info\n\nInformation about a running script\n----------------------------------\n\nYou can access certain attributes of a running script through the methods of the\n[`ExecutionInfo`](/google-ads/scripts/docs/reference/adsapp/adsapp_executioninfo)\nobject. For example,\n[`isPreview()`](/google-ads/scripts/docs/reference/adsapp/adsapp_executioninfo#isPreview)\ntells you whether a script is currently being previewed or is actually\nexecuting.\n\nThis often simplifies debugging code: \n\n // Code that generates a report.\n // ...\n if (!AdsApp.getExecutionInfo().isPreview()) {\n // Do not email the report when in preview mode!\n MailApp.sendEmail(\"customer@example.com\", \"Report is ready!\", report);\n }\n\nInformation about a script's account\n------------------------------------\n\nAccount information for a running script is often needed, especially when the\nsame unchanged script is used in multiple accounts. If the script is emailing\nout a report, the recipient needs to identify the originating account. You can\nuse the\n[`Account`](/google-ads/scripts/docs/reference/adsapp/adsapp_account)\nobject's\n[`getCustomerId()`](/google-ads/scripts/docs/reference/adsapp/adsapp_account#getCustomerId)\nmethod for this: \n\n let accountId = AdsApp.currentAccount().getCustomerId();\n MailApp.sendEmail(\"customer@example.com\",\n \"Report is ready for \" + accountId, report);\n\nThe `Account` object also has methods to let you identify the account's\ncurrency and time zone."]]
