سجلات التنفيذ
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض نصوص "إعلانات Google" البرمجية نوعَين من سجلّات التنفيذ، وذلك في كلّ من وضع المعاينة وعمليات التنفيذ الفعلية: سجلّات التغييرات ونتائج السجلّات.
- سجلّ التغييرات
تعرِض سجلّات التغييرات جميع التغييرات التي تم إجراؤها على عناصر "إعلانات Google" بواسطة البرنامج النصي، بما في ذلك وصف العنصر ونوع التغيير والقيمة قبل التغيير وبعده والأخطاء (إن وُجدت):

يمكن فلترة سجلّات التغييرات بشكل أكبر لعرض الأخطاء فقط.
- مخرجات السجلّات
إذا نفّذت console.log("Hello world!");
في نص برمجي، ستظهر عبارة "Hello
world!" في السجلات. يُعدّ تسجيل أجزاء من النص مفيدًا بشكل خاص أثناء تصحيح الأخطاء، ولكنّه يكون مفيدًا أيضًا أثناء عمليات التنفيذ المباشر.
لنفترض أنّه تمّت جدولة النص البرمجي التالي ليتم تنفيذه يوميًا:
let spreadsheet = SpreadsheetApp.create("Daily Report");
// Populate the spreadsheet.
// ...
console.log("Daily report ready!");
console.log(spreadsheet.getUrl());
في كل عملية تنفيذ، يسجّل النص البرمجي عنوان URL لجدول البيانات الذي تم إنشاؤه حديثًا، ما يسهّل العثور عليه لاحقًا. يمكنك أيضًا استخدام console.warn()
أو console.error()
لتسجيل نص باللون البرتقالي أو الأحمر في السجلات.
بالإضافة إلى رسائل السجلّ التي يحدّدها المبرمج، ستظهر أيضًا أي أخطاء وتحذيرات تواجهها نصوص "إعلانات Google" البرمجية أثناء التنفيذ في سجلّات النصوص.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-10 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-10 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Ads scripts provide two types of execution logs: Changes logs (tracking entity modifications) and Logs output (displaying script messages).\u003c/p\u003e\n"],["\u003cp\u003eChanges logs detail all alterations made by the script to Google Ads entities, including before and after values, and can be filtered to show only errors.\u003c/p\u003e\n"],["\u003cp\u003eLogs output displays messages generated by the script using \u003ccode\u003econsole.log\u003c/code\u003e, \u003ccode\u003econsole.warn\u003c/code\u003e, and \u003ccode\u003econsole.error\u003c/code\u003e, useful for debugging and providing context during live executions.\u003c/p\u003e\n"],["\u003cp\u003eErrors and warnings encountered by scripts during execution are automatically included in the text logs for troubleshooting.\u003c/p\u003e\n"]]],[],null,["Google Ads scripts display two types of execution logs, both in preview mode and in\nreal executions: Changes logs and Logs output.\n\nChanges log\n\n: Changes logs display all changes to Google Ads entities performed by the\n script: entity description, type of change, value before and after, and errors\n (if any):\n\n:\n\n: Changes logs can be further filtered to only display errors.\n\nLogs output\n\n: If you execute `console.log(\"Hello world!\");` in a script, \"Hello\n world!\" appears in the logs. Logging bits of text is particularly useful\n during debugging, but is often helpful during live executions too.\n Suppose the following script is scheduled to run daily:\n\n let spreadsheet = SpreadsheetApp.create(\"Daily Report\");\n // Populate the spreadsheet.\n // ...\n console.log(\"Daily report ready!\");\n console.log(spreadsheet.getUrl());\n\n: In every execution, the script logs the URL of the newly created spreadsheet,\n making it easier to find later. You can also use `console.warn()` or\n `console.error()` for logging orange or red text in the logs.\n\nIn addition to programmer-specified log messages, any\n[errors and warnings](/google-ads/scripts/docs/concepts/errors) the Google Ads scripts\nencounters during execution will also appear in the text logs."]]