Apps Script 資訊主頁

您可以在 Apps Script 資訊主頁中管理及監控 Apps Script 專案。您可以使用資訊主頁執行下列任一操作：

  • 查看及搜尋現有的 Apps Script 專案，包括附加至 Google Workspace 文件的繫結指令碼。
  • 建立新專案。
  • 查看專案詳細資料，例如使用的 OAuth 範圍。
  • 監控指令碼專案的健康狀態和使用情形。
  • 查看專案的執行記錄，以及使用您帳戶憑證執行的其他專案。
  • 開啟或關閉「Apps Script API」，允許或禁止應用程式使用該 API 與指令碼專案互動。

查看及搜尋專案

Apps Script 資訊主頁會列出您可以查看或編輯的所有指令碼專案。資訊主頁的左側導覽列會將這些專案分成以下類別：

  • 已加星號的專案。您監控的專案。
  • 我的專案。您是擁有者的專案。
  • 所有專案。您擁有或有權查看/編輯的專案。
  • 與我共用。您不擁有的專案，但已與您共用。
  • 垃圾桶。從 Google 雲端硬碟移除的專案。

專案清單會顯示專案名稱、擁有者和上次修改日期。專案名稱旁的圖示會指出專案是獨立專案還是繫結專案。

查看專案詳細資料

每個專案都包含一個檢視畫面，可查看專案的開發人員詳細資料。如要查看專案詳細資料，請按一下專案清單中的資料列。

專案詳細資料檢視畫面會顯示專案的錯誤率、執行次數和使用者資料和圖表，以及使用專案的任何使用者要求的 OAuth 範圍。資料指標定義如下：

  • 錯誤率。因未處理的例外狀況而無法執行的百分比。計算方式為指定時間範圍內的失敗執行次數除以總執行次數。
  • 執行。專案的「執行」次數。如要進一步瞭解專案的執行方式，請參閱「執行類型」。
  • 使用者。在指定時間範圍內，執行專案一或多次的不重複使用者 (帳戶) 人數。系統不會追蹤匿名使用者，因此使用者人數或圖表不會反映這類使用者。

專案的每個部署作業都會顯示為「專案詳細資料」頁面上的分頁標籤，位於資料和圖表上方；您可以選取分頁標籤，查看該部署作業的相關資料。選取「全部」會顯示所有專案部署作業的匯總資料，以及開發人員從 Apps Script 程式碼編輯器執行專案所產生的執行作業。

監控專案

您可能可以存取遠多於您經常使用或管理的 Apps Script 專案。如要將專案加入書籤，方便日後存取，可以為專案加上星號。 為專案加上星號後，您也可以監控這些專案的匯總用量和錯誤率統計資料與圖表。

如要為專案加上星號，請按一下專案列右側的「更多」圖示 ，然後選取「新增星號」。您也可以在查看專案詳細資料時，按一下「更多」圖示 ，為專案加上星號。

在左側導覽列中，選取「已加星號的專案」即可查看已加入書籤的專案。按一下頁面頂端的「錯誤率」、「執行次數」或「使用者」評量表，即可查看過去 7 天內所有已加星號專案的相關圖表。

如要移除專案的星號，請按一下專案列中的「更多」圖示 ，然後選取「移除星號」。

管理執行作業

您可以使用 Apps Script 資訊主頁，查看及管理 Apps Script 專案函式的個別執行作業。如要查看最近執行的完整記錄，請在左側導覽選取「我的執行作業」項目。

「我的執行作業」面板預設會顯示您是擁有者、編輯者或檢視者的專案，所有先前和目前執行的作業記錄。如果函式是代表您在您無權存取的專案中執行 (例如您安裝及執行的外掛程式)，這份清單也可能包含這類函式執行作業。執行清單只會顯示呼叫的初始函式，用來啟動執行作業。不會顯示該執行作業期間呼叫的所有函式。

您可以使用檢視畫面頂端的篩選器，控制要在記錄中回報哪種執行類型。記錄檔的每一列都代表一次執行作業。「開始時間」、「時間長度」和「狀態」欄會顯示該執行的相關資訊。

「函式」欄會顯示啟動執行的函式名稱。如果您無法存取執行的對應指令碼專案，但該專案代表您執行，則這個資料欄中不會顯示名稱。

「類型」欄會顯示啟動執行的項目。 相關的值包括：

  • 加購。執行作業源自於外掛程式。
  • Execution API。執行作業源自於對 Apps Script API 的叫用。
  • 時間驅動。執行作業是由時間事件所觸發。
  • 觸發條件。執行作業源自於觸發條件來源。
  • Webapp。執行作業源自於已部署的網頁應用程式。
  • 編輯者。執行作業源自 Apps Script 編輯器。

終止執行作業

目前正在執行的長時間執行作業會以「執行中」的狀態表示。如要停止這些執行作業，請按一下專案列右側的「更多」圖示 >「終止」。

設定

如要調整資訊主頁設定，請選取左側導覽列中的「設定」。

「設定」面板中會顯示 Apps Script API 的切換按鈕。這樣一來，您就能授予 API 存取指令碼專案的權限。

如要存取這個切換按鈕，請按一下「設定」面板中的「Google Apps Script API」標籤。系統會開啟新面板，顯示警告文字和切換開關。基於安全考量，系統預設會關閉指令碼專案的存取權。授權後，您允許的任何第三方應用程式都能使用 API 修改指令碼和部署作業。你隨時可以前往「設定」面板撤銷這項存取權。

詳情請參閱 Apps Script API 存取指南。