Apps Script 資訊主頁

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

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

查看及搜尋專案

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

  • 已加星號的專案。您正在監控的專案。
  • 我的專案。您是擁有者的專案。
  • 所有專案。您擁有或具備查看或編輯權限的專案。
  • 與我共用。非您擁有的但與您共用的專案。
  • 垃圾桶:已從 Google 雲端硬碟移除的專案。

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

查看專案詳細資料

每個專案都包含檢視表,方便您查看專案開發人員詳細資料。如要查看專案的詳細資料,請按一下專案清單中的資料列。

專案詳細資料檢視畫面會顯示專案的「Error rate」(錯誤率)、「Executions」(執行) 和「Users」(使用者) 資料及圖表,以及針對任何使用這項專案的使用者提出的 OAuth 範圍。資料指標的定義如下:

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

專案的每項部署作業,在資料和圖表上方的「Project Details」(專案詳細資料) 頁面上都會顯示為分頁,您可以選取分頁標籤來查看部署作業的相關資料。選取 [全部] 即可查看所有專案部署作業的匯總資料,以及開發人員在 Apps Script 程式碼編輯器中執行專案所導致的執行作業。

監控專案

您平時使用的 Apps Script 專案數量,可能比一般的管理或管理數量高出許多。只要將專案加上星號,即可輕鬆存取。 加上星號專案可讓您監控這些專案的匯總使用情形和錯誤率統計資料和圖表。

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

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

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

管理執行作業

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

根據預設,「My Executions」(我的執行)面板會針對您、擁有者、檢視者或檢視者的專案,顯示所有先前執行中的執行作業記錄。這份清單也可以納入您沒有執行權限的專案執行作業,例如以您的名義執行的外掛程式 (例如您已安裝並執行的外掛程式)。執行清單只會顯示呼叫開始的初始函式。而不會顯示該執行作業期間呼叫的所有函式。

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

「Function」(函式) 資料欄會顯示啟動執行作業的函式名稱。如果您無法存取執行作業的對應指令碼專案,但該欄已經代您執行,則此欄不會顯示名稱。

「Type」(類型) 欄會顯示開始執行的項目。相關的值包括:

  • 外掛程式。執行作業源自外掛程式。
  • 執行 API。執行作業源自於 Apps Script API 的叫用。
  • 時間驅動。執行作業是由時間事件造成。
  • 觸發條件。執行作業來自觸發來源。
  • 網頁應用程式。執行作業來自已部署的網頁應用程式。
  • 編輯者:系統是根據 Apps Script 編輯器執行執行作業。

終止執行作業

進行中的長時間執行作業會由「跑步」的狀態表示。如要停止這些執行作業,請按一下專案列右側的「更多」圖示 >「Terminate」(終止)

設定

如要調整資訊主頁設定,請選取左側導覽面板中的「設定」

在「設定」面板中,是 Apps Script API 的切換按鈕。這可讓您授予 API 指令碼專案的存取權

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

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

支援

如果發生錯誤,或無法順利使用 Apps Script 資訊主頁,請先搜尋或張貼 Stack Overflow

提出新問題

錯誤

如果您確定造成問題的原因是資訊主頁本身發生錯誤,請搜尋 Issue Tracker 來判斷問題是否為已知問題。如果有問題,請按一下問題編號旁邊的星號,即可優先收到更多星號的錯誤。也可以針對現有問題新增註解,但只有在您想要新增問題背景資訊或相關資訊時,才需要執行這項操作。

如果該問題是全新的問題,您也可以透過 Issue Tracker 回報。如果正確無誤,請務必在錯誤說明中提供下列資訊:

  • 問題描述及您原先預期的行為。
  • 可用來重現問題的步驟清單。
  • 您預期的輸出內容以及實際發生情況的說明。請一併加入您收到的任何錯誤訊息。
  • 開發環境相關資訊,包括程式設計語言和程式庫版本等。

請注意,一段時間過後,問題可能相對安靜。這不代表我們一律無法修正問題;這意味著目前沒有更新。

回報新錯誤

缺少功能

如果您希望 dashboad 中缺少某個功能,請搜尋 Issue Tracker 來判斷是否有其他特別要求。如果已要求過要求,請將問題加上星號 (按一下問題編號旁的星號),以便我們優先收到更多星號。您也可以為現有問題新增註解,但只有在您已新增有關問題脈絡或其他資訊時,才需要這麼做。

如果尚未要求該功能,您可以在 Issue Tracker 上提交功能要求。請說明您希望新增的特定功能及其重要性;盡可能詳述這項功能的用途,以及能帶來哪些新商機。

要求新功能