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