Apps Script 資訊主頁

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

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

查看及搜尋專案

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

  • 已加星號的專案。由您「監控」monitoring的專案。
  • 「我的專案」。您是專案的擁有者。
  • 所有專案:您擁有或有權查看或編輯的專案。
  • 與我共用。非您擁有,但他人與您共用的專案。
  • 垃圾桶:您已從 Google 雲端硬碟移除的專案。

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

查看專案詳細資料

每項專案都會提供一個檢視畫面,方便您查看有關專案的開發人員詳細資料。如要查看專案的詳細資料,請在專案清單中按一下對應的資料列。

專案詳細資料檢視畫面會顯示有關專案的「Error rate」(錯誤率)、「Executions」和「Users」(使用者) 資料和圖表,以及使用專案的所有使用者要求的 OAuth 範圍。資料指標的定義如下:

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

在資料和圖表上方,每項專案部署作業都會以分頁形式顯示在「Project Details」頁面上。您可以選取分頁標籤,查看該部署的相關資料。選取「ALL」會顯示專案所有部署的匯總資料,以及來自透過 Apps Script 程式碼編輯器執行專案的開發人員所產生的執行結果。

監控專案

此外,您存取的 Apps Script 專案數量,或許會遠超過您定期使用或管理的 Apps Script 專案。如要將專案加入書籤以便輕鬆存取,您可以為專案加上星號。為專案加上星號後,您也能監控專案的匯總用量和錯誤率統計資料與圖表。

如要為專案加上星號,請在專案列右側依序點選「更多」圖示 >「新增星號」。您也可以在查看專案詳細資料時,按一下「更多」圖示 ,為專案加上星號。

您可以在左側導覽面板中選取「已加星號的專案」,查看已加入書籤的專案。按一下頁面頂端的「Error rate」(錯誤率)、「Executions」或「Users」(使用者) 評量表,即可查看過去 7 天內所有已加星號專案的相關圖表。

如要移除專案星號,請在專案列中按一下「更多」,然後選取「移除星號」

管理執行作業

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

根據預設,「My Executions」面板會顯示過去和目前執行中專案的所有執行作業記錄,且您具備這些專案的擁有者、編輯者或檢視者。這份清單也可包含您無權存取的專案函式執行作業 (例如:您已安裝及執行的外掛程式)。執行作業清單只會顯示為了啟動執行作業而呼叫的初始函式。但不會顯示該執行期間呼叫的所有函式。

您可以使用檢視畫面頂端的篩選器,控制要在記錄中回報的執行類型。記錄檔的每一列都代表一次執行作業。「Start Time」、「Duration」和「Status」資料欄會顯示該執行作業的對應資訊。

「Function」欄顯示啟動執行作業的函式名稱。如果您無法存取執行作業的對應指令碼專案,但該專案是由您執行,則此欄不會顯示任何名稱。

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

  • 外掛程式。這項執行作業源自外掛程式。
  • Execution API。執行作業源自於叫用 Apps Script API。
  • Time Driven:執行程序是由時間事件所造成。
  • 觸發條件。執行作業源自觸發事件。
  • Webapp:執行作業源自已部署的網頁應用程式。
  • 編輯者:執行作業源自 Apps Script 編輯器。

終止執行作業

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

設定

選取左側導覽窗格中的「Settings」(設定),即可調整資訊主頁設定。

「Settings」面板中是 Apps Script API 的切換按鈕。這麼做可讓您將 API 存取權授予指令碼專案

如要存取這個切換鈕,請按一下「設定」面板中的「Google Apps Script API」標籤。這項操作會開啟新面板,當中含有警告文字和切換開關。為了安全起見,指令碼專案存取權預設為關閉。授予存取權後,您授權的任何第三方應用程式即可使用 API 修改指令碼和部署作業。您隨時可以在「設定」面板中撤銷這項存取權。

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