管理專案

本節將概略介紹 Apps Script API 方法，可用於建立、讀取、修改及監控 Apps Script 專案。「專案管理」範例頁面會顯示 API 管理要求的範例。各個方法的參考說明文件會提供實作詳細資料。

API 方法總覽
建立專案	projects.create 結果：建立基本空白專案，其中不含專案檔案，且具有預設專案資訊清單。 選項：你可以提供專案名稱。您也可以提供 Google 文件、試算表、表單或簡報檔案的 Google 雲端硬碟 ID，做為指令碼的父項，藉此建立繫結指令碼。
讀取專案中繼資料	projects.get 結果：擷取代表專案中繼資料的 Project 物件。這類資料包括專案標題、指令碼 ID、建立者、建立時間和其他詳細資料。
閱讀專案內容	projects.getContent 結果：傳回 File 物件的陣列，專案中的每個程式碼和 HTML 檔案各有一個物件。清單也包含 專案資訊清單 (JSON 檔案)。檔案物件包含檔案的來源內容 (File.source) 和其他中繼資料，例如檔案中的函式清單 (File.functionSet)。 選項：您可以指定要透過查詢參數擷取的內容版本。
更新專案內容	projects.updateContent 結果：變更指令碼專案中的檔案內容。 請以 File 物件陣列的形式提供新內容。其中一個 File 物件必須具有 JSON 類型，並代表指令碼專案的新專案資訊清單。新內容會儲存為專案的 HEAD 版本。當指令碼以觸發條件、指令碼編輯器、外掛程式預覽模式執行，或以網頁應用程式或 Apps Script API 開發模式執行時，就會使用這個值。 注意：更新指令碼專案內容時，一般做法是先發出 projects.getContent 要求，擷取現有 File 的陣列，對這些物件進行所需變更，然後將 File 做為 projects.updateContent 要求的輸入內容。 警告：新內容會取代指令碼專案中的所有現有檔案。系統會移除要求未更新的檔案。
讀取專案指標	projects.getMetrics 結果：讀取專案的特定指標。 這些指標包括使用者人數、執行總次數、執行錯誤總次數和其他詳細資料。使用 MetricType 指定您要求提供的資訊。 選項：使用 MetricsFilter，將結果限制為特定部署或指令碼函式。 您也可以使用 MetricsIntervalConfig 定義特定指標間隔。