داشبورد Apps Script به شما امکان میدهد پروژههای Apps Script خود را مدیریت و نظارت کنید. از این داشبورد برای موارد زیر استفاده کنید:
- پروژههای اسکریپت برنامههای موجود خود، از جمله اسکریپتهای محدود شده متصل به اسناد Google Workspace را مشاهده و جستجو کنید.
- پروژههای جدید ایجاد کنید.
- جزئیات مربوط به پروژههای خود، مانند محدودههای OAuth مورد استفاده در آنها را مشاهده کنید.
- سلامت و میزان استفاده از پروژههای اسکریپت خود را رصد کنید.
- گزارشهای اجرای پروژههای خود و سایر پروژههایی که با استفاده از اعتبارنامه حساب شما اجرا میشوند را مشاهده کنید.
- API اسکریپت برنامهها را فعال یا غیرفعال کنید تا به برنامهها اجازه دهید یا از استفاده از API برای تعامل با پروژههای اسکریپت شما جلوگیری کنند.
مشاهده و جستجوی پروژهها
داشبورد Apps Script تمام پروژههای اسکریپتی را که میتوانید مشاهده یا ویرایش کنید، فهرست میکند. منوی سمت چپ داشبورد، این پروژهها را به دستههای زیر تقسیم میکند:
- پروژههای ستارهدار . پروژههایی که شما بر آنها نظارت دارید.
- پروژههای من . پروژههایی که شما مالک آنها هستید.
- همه پروژهها . پروژههایی که مالک آنها هستید یا مجوزهای مشاهده یا ویرایش آنها را دارید.
- با من به اشتراک گذاشته شده است . پروژههایی که متعلق به شما نیستند اما با شما به اشتراک گذاشته شدهاند.
- زبالهدان . پروژههایی که از گوگل درایو حذف کردهاید.
لیست پروژهها، نام پروژه، مالک و تاریخ آخرین تغییر را نشان میدهد. آیکونهای کنار نام پروژه نشان میدهند که آیا پروژه یک پروژه مستقل است یا یک پروژه محدود .
مشاهده جزئیات پروژه
هر پروژه شامل یک نما برای مشاهده جزئیات توسعهدهنده در مورد پروژه است. برای مشاهده جزئیات مربوط به یک پروژه، روی ردیف مورد نظر از لیست پروژهها کلیک کنید.
The project details view shows Error rate , Executions and Users data and graphs about the project, as well as OAuth scopes requested of any user of the project. Data metrics are defined as follows:
- نرخ خطا . درصد اجراهایی که به دلیل استثنائات شناسایی نشده، با شکست مواجه شدهاند. این نرخ از تقسیم تعداد اجراهای ناموفق بر کل اجراها در دوره زمانی تعریف شده محاسبه میشود.
- اجراها . تعداد دفعاتی که یک پروژه "اجرا" یا اجرا شده است. برای اطلاعات بیشتر در مورد نحوه اجرای یک پروژه، به انواع اجرا مراجعه کنید.
- Users . The number of unique user accounts who ran the project one or more times over the specified time period. Anonymous users are not tracked and therefore are not reflected in the user count or graphs.
Each deployment of your project appears as a tab on the Project Details page preceding the data and graphs; select the tab to see the associated data for that deployment. Selecting ALL shows aggregate data for all of the project's deployments and from executions resulting from developers running the project from within the Apps Script code editor.
پروژههایی که به عنوان افزونه منتشر میشوند، در داشبورد Apps Script به صورت پیادهسازیشده نمایش داده نمیشوند.
نظارت بر پروژهها
پروژهها را با ستارهگذاری نشانهگذاری کنید. ستارهگذاری پروژهها همچنین به شما امکان میدهد آمار و نمودارهای میزان استفاده و خطای کلی را رصد کنید.
برای ستارهدار کردن یک پروژه، در سمت راست ردیف پروژه، روی More > Add star کلیک کنید. همچنین میتوانید هنگام مشاهده جزئیات پروژه ، با کلیک روی More یک پروژه را ستارهدار کنید.
در منوی سمت چپ، برای مشاهده پروژههایی که نشانهگذاری کردهاید، «پروژههای ستارهدار» را انتخاب کنید. برای مشاهده نمودارهای مرتبط با تمام پروژههای ستارهدار خود در ۷ روز گذشته، روی « نرخ خطا» ، «اجراها » یا «کارت امتیازی کاربران» در بالای صفحه کلیک کنید.
با کلیک روی More در ردیف پروژه و انتخاب Remove star، یک ستاره را از آن پروژه حذف کنید.
مدیریت اجراها
از داشبورد Apps Script برای مشاهده و مدیریت اجراهای تک تک توابع پروژه Apps Script استفاده کنید. با انتخاب My Executions در منوی سمت چپ، گزارش کاملی از اجراهای اخیر را بیابید.
The My Executions panel shows a log of all previous and running executions for projects for which you are an owner, editor or viewer. This list can also include function executions in projects that you don't have access to if they run on your behalf (for example, add-ons that you've installed and run). The execution list only shows the initial function that is called to start the execution. It doesn't show every function called during that execution.
Control which type of execution is reported in the log using the filters at the top of the view. Each row of the log represents a single execution. The Start Time , Duration , and Status columns show the corresponding information about that execution.
The Function column shows the name of the function that initiated the execution. There is no name in this column if you don't have access to the execution's corresponding script project but it ran on your behalf.
ستون نوع (Type) نشان میدهد چه چیزی اجرا را آغاز کرده است. مقادیر شامل موارد زیر هستند:
- اضافه کردن . اجرا از یک افزونه سرچشمه گرفته است.
- رابط برنامهنویسی کاربردی اجرا . اجرا از فراخوانی رابط برنامهنویسی کاربردی Apps Script آغاز شد.
- زمانمحور . اجرا ناشی از یک رویداد زمانی بود.
- تریگر . اجرا از یک منبع تریگر آغاز شده است.
- برنامه وب . اجرا از یک برنامه وب مستقر شده آغاز شد.
- ویرایشگر . اجرا از ویرایشگر Apps Script آغاز شد.
خاتمه دادن به اعدامها
اجراهای طولانی مدت که در حال انجام هستند با وضعیت "در حال اجرا" نشان داده میشوند. برای متوقف کردن این اجراها، در سمت راست ردیف پروژه، روی More > Terminate کلیک کنید.
تنظیمات
تنظیمات داشبورد خود را با انتخاب تنظیمات در منوی سمت چپ تنظیم کنید.
در پنل تنظیمات ، گزینهای برای API اسکریپت برنامهها وجود دارد. این گزینه به شما امکان میدهد به API اجازه دسترسی به پروژههای اسکریپت خود را بدهید.
To access this toggle click the Google Apps Script API label in the Settings panel. This opens a new panel with warning text and a toggle switch. Access to your script projects is toggled off by default as a security precaution. Once you grant access, any third-party application you authorize can use the API to modify your scripts and deployments. Revoke this access in the Settings panel at any time.
اطلاعات بیشتر را در راهنمای دسترسی به API اسکریپت برنامهها بیابید.