管理專案

本節將概略說明 Google Apps Script API 方法，您可以使用這些方法建立、讀取、修改及監控 Google Apps Script 專案。「專案管理」範例頁面會顯示 API 管理要求的範例。每種方法的參考說明文件都提供實作詳細資料。

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