داشبورد 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 اسکریپت برنامهها بیابید.