Apps Script 資訊主頁可讓您管理及監控 Apps Script 專案。您可以使用資訊主頁執行下列任一操作:
- 查看及搜尋現有的 Apps 指令碼專案,包括附加至Google Workspace 文件的繫結指令碼。
- 建立新專案。
- 查看專案詳細資料,例如所使用的 OAuth 範圍。
- 監控指令碼專案的健康狀態和用量。
- 查看專案和其他使用帳戶憑證執行的作業記錄。
- 開啟或關閉 Apps Script API,允許或禁止應用程式使用 API 與指令碼專案互動。
查看及搜尋專案
Apps Script 資訊主頁會列出您可以查看或編輯的所有指令碼專案。資訊主頁左側的導覽面板會將這些專案分為下列類別:
- 已加星號的專案。您監控的專案。
- 我的專案。您擁有的專案。
- 所有專案。你擁有或具備查看或編輯權限的專案。
- 與我共用。你不擁有但與你共用的專案。
- 垃圾桶。從 Google 雲端硬碟移除的專案。
專案清單會顯示專案名稱、擁有者和上次修改日期。專案名稱旁的圖示會指出專案是獨立專案還是繫結專案。
查看專案詳細資料
每個專案都包含一個檢視畫面,可查看專案的開發人員詳細資料。如要查看專案詳細資料,請按一下專案清單中的資料列。
專案詳細資料檢視畫面會顯示有關專案的錯誤率、執行作業和使用者資料和圖表,以及使用專案的任何使用者要求的 OAuth 範圍。資料指標的定義如下:
- 錯誤率。因未偵測到的例外狀況而無法執行的執行作業百分比。計算方式為失敗執行次數除以指定時間範圍內的總執行次數。
- 執行次數:專案的「執行」或執行次數。如要進一步瞭解如何執行專案,請參閱「執行類型」。
- 使用者。在指定時間範圍內,執行過一次以上專案的不重複使用者 (帳戶) 人數。系統不會追蹤匿名使用者,因此使用者人數或圖表中不會顯示這類使用者。
每個專案部署作業都會以分頁的形式顯示在「Project Details」頁面上,位於資料和圖表上方;您可以選取分頁,查看該部署作業的相關聯資料。選取「ALL」後,系統會顯示所有專案部署作業的匯總資料,以及開發人員在 Apps Script 程式碼編輯器中執行專案所產生的執行作業。
監控專案
您可能可以存取比平常使用或管理的更多 Apps Script 專案。如要將專案加入書籤以便存取,可以為專案加上星號。您也可以透過收藏專案,監控這些專案的匯總使用量和錯誤率統計資料和圖表。
如要為專案加星號,請在專案資料列的右側,依序點選「更多」圖示 查看專案詳細資料時,按一下「更多」圖示 為專案加上星號。
>「加星號」。您也可以在在左側導覽面板中,您可以選取「已加星號的專案」,查看已加入書籤的專案。按一下頁面頂端的「錯誤率」、「執行次數」或「使用者」評量表,即可查看過去 7 天內所有加星專案的相關圖表。
如要移除專案的星號,請按一下專案列中的「更多」圖示
,然後選取「移除星號」。管理執行作業
您可以使用 Apps Script 資訊主頁查看及管理個別 Apps Script 專案函式的執行作業。您可以選取左側導覽面板中的「我的執行作業」項目,查看最近執行作業的完整記錄。
根據預設,「我的執行作業」面板會顯示您擁有者、編輯者或檢視者的專案,先前和目前執行作業的記錄。這個清單也可能包含您沒有存取權的專案中,由系統代您執行的函式 (例如您已安裝及執行的外掛程式)。執行清單只會顯示用於啟動執行作業的初始函式。但不會顯示在執行期間呼叫的所有函式。
您可以使用檢視畫面頂端的篩選器,控制記錄中要回報的執行類型。記錄的每一列都代表單一執行作業。「開始時間」、「持續時間」和「狀態」欄會顯示執行作業的對應資訊。
「Function」欄會顯示啟動執行作業的函式名稱。如果您沒有執行作業的對應指令碼專案存取權,但系統代您執行作業,這個欄位就不會顯示名稱。
「Type」欄會顯示執行作業的原因。相關的值包括:
- 加裝。執行作業源自外掛程式。
- Execution API:執行作業源自於 Apps Script API 的叫用。
- 時間驅動。執行作業是因為時間事件而發生。
- 觸發條件。執行作業源自觸發條件來源。
- Webapp。執行作業源自於已部署的網頁應用程式。
- 編輯者。執行作業源自於 Apps Script 編輯器。
終止執行作業
目前進行中的長時間執行作業會顯示「執行中」狀態。如要停止這些執行作業,請在專案資料列的右側依序按一下「更多」圖示
>「終止」。設定
如要調整資訊主頁設定,請在左側導覽面板中選取「設定」。
「設定」面板中,有一個 Apps Script API 切換鈕。這樣一來,您就能授予 API 存取指令碼專案的權限。
如要存取此切換鈕,請按一下「Settings」面板中的「Google Apps Script API」標籤。這會開啟一個面板,其中包含警告文字和切換鈕。為確保安全,系統預設會關閉指令碼專案的存取權。授予存取權後,您授權的任何第三方應用程式都可以使用 API 修改指令碼和部署作業。您隨時可以在「設定」面板中撤銷這項存取權。
詳情請參閱 Apps Script API 存取權指南。