Page Summary

outlined_flag

• The Apps Script dashboard is used to manage and monitor your Apps Script projects.

• You can view and search for projects, including bound scripts attached to Google Workspace documents.

• The dashboard allows you to view project details like OAuth scopes, monitor health and usage, and view execution logs.

• You can star projects to monitor aggregate usage and error rate statistics easily.

• The Apps Script API can be toggled on or off in the settings to control external access to your script projects.

TheApps Script dashboard lets you manage andmonitor your Apps Script projects. You can use the dashboard to do any ofthe following:

• View and search for your existing Apps Script projects, includingbound scripts attached toGoogle Workspace documents.
• Create new projects.
• View details about your projects, such as theOAuth scopes it uses.
• Monitor the health and usage of your script projects.
• View execution logs for your projects and others that run using your account'scredentials.
• Toggle on or off theApps Script API to allowor prevent apps from using the API to interact with your script projects.

View and search projects

The Apps Script dashboard lists all the script projects that you can view oredit. The left nav of the dashboard divides these projects into the followingcategories:

• Starred Projects. Projects that you aremonitoring.
• My Projects. Projects for which you are an owner.
• All Projects. Projects which you own or have view or edit permissions for.
• Shared with me. Projects that you do not own but that have been sharedwith you.
• Trash. Projects that you have removed from Google Drive.

The project lists show the project name, owner, and last modified date. Theicons next to the project name indicate whether the project is astandaloneproject or abound project.

View project details

Each project includes a view to see developer details about the project. Toview the details about a project, click the row from the project list.

The project details view showsError rate,Executions andUsersdata and graphs about the project, as well asOAuth scopes requested of any end-user usingthe project. The data metrics are defined as follows:

• Error rate. The percent of executions that failed to run due touncaught exceptions. It is calculated as failed executions divided by thetotal executions over the defined time period.
• Executions. The number of times a project has been "run" or executed.SeeExecution types for more information about how aproject can be run.
• Users. The number of unique user (accounts) who ran the project one ormore times over the specified time period. Anonymous users are not trackedand therefore are not reflected in the user count or graphs.

Each deployment of your project appears as a tab on theProject Detailspage above the data and graphs; you can select the tab tosee the associated data for that deployment. SelectingALL showsaggregate data for all of the project's deployments and from executionsresulting from developers running the project from within the Apps Scriptcode editor.

To star a project, on the right of a project row, click Moremore_vert >Add star. You can also star a project by clicking Moremore_vertwhileviewing project details.

In the left nav, you can selectStarred Projects to see the projectsyou've bookmarked. Click theError rate,Executions orUsersscorecard at the top of the page to see the associated graphs for all yourstarred projects over the last 7 days.

You can remove a star from a project by clicking Moremore_vert in its project row andselectingRemove star.

Manage executions

You can use the Apps Script dashboard to view and manage individual executionsof Apps Script project functions. You can find a full log of recentexecutions by selecting theMy Executions item in the left nav.

TheMy Executions panel shows by default a log of all previous and currentlyrunning executions for projects for which you are an owner, editor orviewer. This list can also include function executions in projects that youdon't have access to if they run on your behalf (for example, add-ons thatyou've installed and run). The execution list only shows the initial functionthat is called to start the execution. It does not show every function thatwas called during that execution.

You can control which type of execution is reported in the log using thefilters at the top of the view. Each row of the log represents a singleexecution. TheStart Time,Duration, andStatus columns show thecorresponding information about that execution.

TheFunction column shows the name of the function that initiatedthe execution. There is no name in this column if you don't have access tothe execution's corresponding script project but it ran on your behalf.

TheType column shows what initiated the execution.Values include:

• Add On. The execution originated from an add-on.
• Execution API. The execution originated from an invocation of theApps Script API.
• Time Driven. The execution was caused by a time event.
• Trigger. The execution originated from a trigger source.
• Webapp. The execution originated from a deployed web app.
• Editor. The execution originated from the Apps Script editor.

Terminate executions

Long running executions that are currently in-progress are indicated by aStatus of "Running". To stop these executions, on the right of the projectrow, click Moremore_vert >Terminate.

Settings

You can adjust your dashboard settings by selectingSettings in theleft nav.

In theSettings panel is a toggle fortheApps Script API. This lets you grant the APIaccess to your script projects.

To access this toggle click theGoogle Apps Script APIlabel in theSettings panel. This opens a new panel with warning text anda toggle switch. Access to your script projects is toggled off by defaultas a security precaution. Once you grant access, any third-party applicationyou authorize can use the API to modify your scripts and deployments. You canrevoke this access in theSettings panel at any time.

Find more information in theApps Script API access guide.