داشبورد Apps Script به شما امکان میدهد پروژههای Apps Script خود را مدیریت و نظارت کنید. از این داشبورد برای موارد زیر استفاده کنید:
- پروژههای اسکریپت برنامههای موجود خود، از جمله اسکریپتهای محدود شده متصل به اسناد Google Workspace را مشاهده و جستجو کنید.
- پروژههای جدید ایجاد کنید.
- جزئیات مربوط به پروژههای خود، مانند محدودههای OAuth مورد استفاده در آنها را مشاهده کنید.
- سلامت و میزان استفاده از پروژههای اسکریپت خود را رصد کنید.
- گزارشهای اجرای پروژههای خود و سایر پروژههایی که با استفاده از اعتبارنامه حساب شما اجرا میشوند را مشاهده کنید.
- API اسکریپت برنامهها را فعال یا غیرفعال کنید تا به برنامهها اجازه دهید یا از استفاده از API برای تعامل با پروژههای اسکریپت شما جلوگیری کنند.
مشاهده و جستجوی پروژهها
داشبورد Apps Script تمام پروژههای اسکریپتی را که میتوانید مشاهده یا ویرایش کنید، فهرست میکند. منوی سمت چپ داشبورد، این پروژهها را به دستههای زیر تقسیم میکند:
- پروژههای ستارهدار . پروژههایی که شما بر آنها نظارت دارید.
- پروژههای من . پروژههایی که شما مالک آنها هستید.
- همه پروژهها . پروژههایی که مالک آنها هستید یا مجوزهای مشاهده یا ویرایش آنها را دارید.
- با من به اشتراک گذاشته شده است . پروژههایی که متعلق به شما نیستند اما با شما به اشتراک گذاشته شدهاند.
- زبالهدان . پروژههایی که از گوگل درایو حذف کردهاید.
لیست پروژهها، نام پروژه، مالک و تاریخ آخرین تغییر را نشان میدهد. آیکونهای کنار نام پروژه نشان میدهند که آیا پروژه یک پروژه مستقل است یا یک پروژه محدود .
مشاهده جزئیات پروژه
هر پروژه شامل یک نما برای مشاهده جزئیات توسعهدهنده در مورد پروژه است. برای مشاهده جزئیات مربوط به یک پروژه، روی ردیف مورد نظر از لیست پروژهها کلیک کنید.
نمای جزئیات پروژه، دادهها و نمودارهای مربوط به نرخ خطا ، اجراها و کاربران و همچنین محدودههای OAuth درخواست شده از هر کاربر پروژه را نشان میدهد. معیارهای داده به شرح زیر تعریف میشوند:
- نرخ خطا . درصد اجراهایی که به دلیل استثنائات شناسایی نشده، با شکست مواجه شدهاند. این نرخ از تقسیم تعداد اجراهای ناموفق بر کل اجراها در دوره زمانی تعریف شده محاسبه میشود.
- اجراها . تعداد دفعاتی که یک پروژه "اجرا" یا اجرا شده است. برای اطلاعات بیشتر در مورد نحوه اجرای یک پروژه، به انواع اجرا مراجعه کنید.
- کاربران . تعداد حسابهای کاربری منحصر به فردی که پروژه را یک یا چند بار در یک دوره زمانی مشخص اجرا کردهاند. کاربران ناشناس ردیابی نمیشوند و بنابراین در تعداد کاربران یا نمودارها منعکس نمیشوند.
هر استقرار پروژه شما به صورت یک تب در صفحه جزئیات پروژه، قبل از دادهها و نمودارها ظاهر میشود؛ برای مشاهده دادههای مرتبط با آن استقرار، تب را انتخاب کنید. انتخاب ALL، دادههای تجمیعی مربوط به همه استقرارهای پروژه و اجراهای حاصل از اجرای پروژه توسط توسعهدهندگان از درون ویرایشگر کد Apps Script را نشان میدهد.
پروژههایی که به عنوان افزونه منتشر میشوند، در داشبورد Apps Script به صورت پیادهسازیشده نمایش داده نمیشوند.
نظارت بر پروژهها
پروژهها را با ستارهگذاری نشانهگذاری کنید. ستارهگذاری پروژهها همچنین به شما امکان میدهد آمار و نمودارهای میزان استفاده و خطای کلی را رصد کنید.
برای ستارهدار کردن یک پروژه، در سمت راست ردیف پروژه، روی More > Add star کلیک کنید. همچنین میتوانید هنگام مشاهده جزئیات پروژه ، با کلیک روی More یک پروژه را ستارهدار کنید.
در منوی سمت چپ، برای مشاهده پروژههایی که نشانهگذاری کردهاید، «پروژههای ستارهدار» را انتخاب کنید. برای مشاهده نمودارهای مرتبط با تمام پروژههای ستارهدار خود در ۷ روز گذشته، روی « نرخ خطا» ، «اجراها » یا «کارت امتیازی کاربران» در بالای صفحه کلیک کنید.
با کلیک روی More در ردیف پروژه و انتخاب Remove star، یک ستاره را از آن پروژه حذف کنید.
مدیریت اجراها
از داشبورد Apps Script برای مشاهده و مدیریت اجراهای تک تک توابع پروژه Apps Script استفاده کنید. با انتخاب My Executions در منوی سمت چپ، گزارش کاملی از اجراهای اخیر را بیابید.
پنل «اجراهای من» گزارش تمام اجراهای قبلی و در حال انجام پروژههایی را نشان میدهد که شما مالک، ویرایشگر یا بیننده آنها هستید. این لیست همچنین میتواند شامل اجراهای توابع در پروژههایی باشد که به آنها دسترسی ندارید، اگر از طرف شما اجرا شوند (به عنوان مثال، افزونههایی که نصب و اجرا کردهاید). لیست اجرا فقط تابع اولیهای را که برای شروع اجرا فراخوانی میشود نشان میدهد. این لیست تمام توابعی را که در طول آن اجرا فراخوانی میشوند، نشان نمیدهد.
با استفاده از فیلترهای بالای نما، نوع اجرای گزارششده در گزارش را کنترل کنید. هر ردیف از گزارش، نشاندهندهی یک اجرا است. ستونهای Start Time ، Duration و Status اطلاعات مربوط به آن اجرا را نشان میدهند.
ستون تابع ، نام تابعی را که اجرا را آغاز کرده است نشان میدهد. اگر به پروژه اسکریپت مربوطه دسترسی ندارید، اما از طرف شما اجرا شده است، در این ستون نامی وجود ندارد.
ستون نوع (Type) نشان میدهد چه چیزی اجرا را آغاز کرده است. مقادیر شامل موارد زیر هستند:
- اضافه کردن . اجرا از یک افزونه سرچشمه گرفته است.
- رابط برنامهنویسی کاربردی اجرا . اجرا از فراخوانی رابط برنامهنویسی کاربردی Apps Script آغاز شد.
- زمانمحور . اجرا ناشی از یک رویداد زمانی بود.
- تریگر . اجرا از یک منبع تریگر آغاز شده است.
- برنامه وب . اجرا از یک برنامه وب مستقر شده آغاز شد.
- ویرایشگر . اجرا از ویرایشگر Apps Script آغاز شد.
خاتمه دادن به اعدامها
اجراهای طولانی مدت که در حال انجام هستند با وضعیت "در حال اجرا" نشان داده میشوند. برای متوقف کردن این اجراها، در سمت راست ردیف پروژه، روی More > Terminate کلیک کنید.
تنظیمات
تنظیمات داشبورد خود را با انتخاب تنظیمات در منوی سمت چپ تنظیم کنید.
در پنل تنظیمات ، گزینهای برای API اسکریپت برنامهها وجود دارد. این گزینه به شما امکان میدهد به API اجازه دسترسی به پروژههای اسکریپت خود را بدهید.
برای دسترسی به این گزینه، روی برچسب Google Apps Script API در پنل تنظیمات کلیک کنید. این کار یک پنل جدید با متن هشدار و یک سوئیچ تغییر وضعیت باز میکند. دسترسی به پروژههای اسکریپت شما به طور پیشفرض به عنوان یک اقدام احتیاطی امنیتی غیرفعال است. پس از اعطای دسترسی، هر برنامه شخص ثالثی که شما مجاز میدانید میتواند از API برای تغییر اسکریپتها و استقرارهای شما استفاده کند. این دسترسی را در هر زمانی در پنل تنظیمات لغو کنید.
اطلاعات بیشتر را در راهنمای دسترسی به API اسکریپت برنامهها بیابید.