每個 Apps Script 專案使用的單位 使用 Google Cloud 管理授權、 進階服務等等。 如要設定及管理這些設定,每個 Apps Script 專案都有 相關聯的 Google Cloud 專案 指令碼專案可以使用 Apps Script 的預設專案 自動建立或 您建立的 standard 專案 你自己。一般來說,預設專案適合日常使用或 但您應該針對標準專案 較為複雜、商業品質,或者您想發布的內容
您可以從預設專案切換至標準專案 但無法改回使用預設專案。最好 ,選取指令碼在開發初期使用的 Cloud 專案。 日後切換可能會引起一些小工具,例如要求使用者使用者必須 重新授權。
預設 Cloud 專案
建立 Apps Script 專案時,Apps Script 會建立預設值 在背景中運作的 Cloud 專案。
- 大部分指令碼都不需查看或調整這項預設專案。應用程式 指令碼會處理與 Google Cloud 之間的必要互動。舉例來說 您在 Apps Script 編輯器中啟用 Apps Script 中的進階服務 在下列情況中,啟用預設 Cloud 專案中的進階服務 儲存指令碼專案
- 使用某些指令碼時,您必須與 Google Cloud 控制台互動。在以下 ,你的指令碼必須改用標準 Cloud 專案。適用對象 例如,如要在 Google Cloud 控制台中查看 Google Cloud 記錄檔,您的指令碼必須使用 標準專案
根據預設,Cloud 專案會具備 Identity and Access Management 機制
(IAM) 政策,具有一項目、Google 服務帳戶擔任
預設專案Google 服務帳戶
appsdev-apps-dev-script-auth@system.gserviceaccount.com
。
查看或更新預設 Cloud 專案
大多數使用者無法直接在 Google Cloud 控制台 存取 Google Cloud 控制台如果您是管理員,請參閱「查看預設的 Google Cloud 專案」一文。
如果您是在 2019 年 4 月 8 日前建立指令碼專案,您可以使用 您可以在 Google Cloud 控制台中存取的預設專案如要使用 預設專案,請前往指令碼專案的設定,再按一下專案 號碼。
刪除預設的 Cloud 專案
管理員可以像刪除預設 Cloud 專案一樣, 標準 Cloud 專案請參閱「刪除 Apps Script Cloud 專案」。
如果您不是管理員,則無法刪除預設專案。不過,在下列情況下,Apps Script 會刪除預設專案:
- 如果刪除指令碼專案或將其改為使用標準專案,應用程式 指令碼會刪除已附加至指令碼的預設專案,以及任何 設定或所含資訊
- 如果指令碼未執行超過 180 天,Apps Script 則會刪除相關聯的預設專案如果指令碼的執行位置晚於 Apps Script 會刪除其預設專案,而 Apps Script 會為 指令碼
標準 Cloud 專案
對大部分的指令碼專案而言,預設 Cloud 專案是最佳選擇 除非您需要手動設定專案 在這些情況下,您必須 將指令碼專案改為使用標準專案。
以下各節說明 Apps Script 需要使用標準專案的時機、 專案的屬性及常見工作只有在 可透過標準專案執行下列工作。
Apps Script 需要標準 Cloud 專案的情況
如遇下列情況,您必須使用標準專案:
- 如要將指令碼專案發布為 加購內容 Google Workspace Marketplace 中的應用程式。
- 驗證指令碼專案的 OAuth 用戶端。
- 如果有應用程式需要在
編寫指令碼專案
Apps Script API 的
scripts.run
方法。 - 如要查看指令碼專案的 Google Cloud 記錄檔 Google Cloud 控制台。Google Cloud 控制台提供更多篩選工具 而且相較於 Vertex AI Pipelines 提供的簡易檢視 Apps Script 資訊主頁。
- 如要查看指令碼專案的錯誤報告,請使用 Error Reporting。
- 建立「檔案開啟」對話方塊。
- 在其他情況下,您需要手動控管專案的 Google Cloud 設定。
標準 Cloud 專案屬性
標準專案的屬性如下:
- 您可以直接存取專案的所有 Google Cloud 設定 使用 Google Cloud 控制台設定。以便啟用 API、調整授權 憑證,並設定其他詳細資料
- 刪除指令碼專案或將專案切換為 使用其他標準專案,原始標準專案仍然存在,且可以 重複使用
- 當您啟用進階服務時 如果要使用指令碼專案,您必須在指令碼專案中手動啟用對應的 API 標準專案
- 多個指令碼專案和其他應用程式可以共用同一個 標準專案如果您打算發布指令碼專案 加入 Google Workspace Marketplace 做為外掛程式 則需要有專屬的標準專案已發布的應用程式無法分享 與其他應用程式的雲端專案搭配使用
- 如要使用其他應用程式的指令碼專案執行函式
Apps Script API 的
scripts.run
方法, 指令碼專案和呼叫應用程式必須共用相同的標準 專案。 - 當 Apps Script 要求使用者授權使用標準的指令碼時 專案時,Cloud 專案名稱會用於識別指令碼 (而非 指令碼專案名稱)。因此,請務必設定適當的 Cloud 專案名稱。
存取標準 Cloud 專案
如要存取與指令碼相關聯的標準專案,請按照下列步驟操作: 專案,請按照下列步驟操作:
- 開啟 Apps Script 專案。
- 按一下左側的「專案設定」圖示 。
- 在「Google Cloud Platform (GCP) Project」(Google Cloud Platform (GCP) 專案) 下方,按一下專案編號。
您也可以直接在 Google Cloud 控制台的「管理資源」頁面中找到標準專案。
在標準 Cloud 專案中啟用 API
Apps Script 應用程式經常需要存取其他 Google API。方法如下 您必須在相應的 Cloud 專案中啟用 API。 請按照下列步驟啟用 API:
- 開啟 Cloud 專案。
- 按一下「選單」圖示 > API 與服務。
- 點選「啟用 API 和服務」。
- 在搜尋框中輸入要啟用的 API,然後按下 Enter 鍵。
- 在搜尋結果中點選 API,然後按一下「啟用」來啟用 為這個 Cloud 專案啟用 API
系統可能會提示您接受 Google API 或 Google Cloud:詳閱條款 接受條款之前,請務必仔細確認。
視應用程式而定,您可能也需要透過以下項目設定 API: 在 API 和服務資訊主頁。
判定 ID 和標準的 Cloud 專案數量
所有 Cloud 專案都會有專案名稱、專案 ID 和專案編號。 有時您需要這些 ID 設定服務或完成其他工作
如要判斷標準專案的 ID 和編號,請按照下列步驟操作:
- 開啟 Cloud 專案。
- 按一下右上方的「更多」圖示 > [專案設定]。
- 查看「專案名稱」、「專案 ID」和「專案編號」。 就會顯示「設定」面板。「專案編號」只包含 專案 ID 則為英數字元。編輯 專案名稱:在授權提示期間向使用者顯示的專案名稱。
查看 Google Cloud 記錄檔與Google Cloud 控制台中的錯誤報告
如果你使用的是 Google Cloud Logging 或錯誤報告 您可以在指令碼專案中查看這些記錄和報表 Google Cloud 控制台,請按照下列步驟操作:
- 開啟 Cloud 專案。
- 按一下「選單」圖示 。
- 向下捲動至「作業」區段 然後依序點選「Logging」>「記錄檔探索工具」。
- 如要查看錯誤報告,請向下捲動至「作業」部分 然後點選「Error Reporting」。如果系統提示 設定錯誤報告,表示您的指令碼專案並未 並記錄所有例外狀況。
完成 OAuth 同意畫面
使用需要 OAuth 的服務時,Google 會提示使用者進行授權 免費 Google Cloud 服務OAuth 同意畫面設定可讓您設定部分資訊 使用者存取的容器 應用程式名稱和服務條款網址
預設 Cloud 專案會自動從 Apps Script 專案詳細資料;無法調整這些設定 採用標準 Cloud 專案後 可以自訂這項資訊你可以設定指令碼的同意聲明 方法如下:
- 開啟 Cloud 專案。
- 按一下「選單」圖示 > API 與服務 >「憑證」。
- 按一下 [Configure consent screen] (設定同意畫面)。
- 填寫同意畫面工作流程的各個部分。
- 如要記錄工作流程中每個階段的變更,請按一下 儲存並繼續。
建立 OAuth 憑證
Apps Script 通常會為服務設定 OAuth 指令碼使用的序列對於某些應用程式,您必須建立額外的 OAuth 憑證 (用戶端 ID 和用戶端密鑰)。這項操作僅適用於 標準專案
如要為指令碼專案建立用戶端 ID 和用戶端密鑰,請執行 包括:
- 開啟 Cloud 專案。
- 按一下「選單」圖示 > API 與服務 >「憑證」。
- 按一下「建立憑證」> OAuth 用戶端 ID。
- 在「應用程式類型」下方選取應用程式類型,然後 視需要填寫結果表單。完成後,點選「建立」。
- 在畫面顯示的對話方塊中,按一下「Download JSON」(下載 JSON)。你可以 使用這個檔案設定 OAuth
為標準 Cloud 專案新增其他擁有者
您可以在標準專案中新增其他擁有者或其他角色。 如果您要協作處理專案 團隊隨時都能存取指令碼專案的 Google Cloud 設定。
如要在標準專案中新增其他擁有者或其他角色,請按照下列步驟操作: 追蹤。必須具備專案的編輯權限,才能 這些變更:
- 決定協作者的身分。我們建議您 建立或使用現有的 Google 群組。你可以 您也可以在協作者清單中指定網域,納入該協作者清單中的所有使用者 網域。
- 開啟指令碼的 Cloud 專案。
- 按一下「選單」圖示 > IAM 與管理員 >「身分與存取權管理」。
- 按一下頂端的「新增」。
- 按照畫面上的指示新增一或多位新成員, 授予 Cloud 專案角色新增個別電子郵件地址、Google 網路論壇或 視為新成員
- 按一下 [儲存]。
使用單一 Cloud 專案將多個指令碼分組
您可以讓多個 Apps Script 專案共用相同的標準 Cloud 專案如要這麼做,請建立標準專案 每個指令碼專案切換 以便使用。但無法透過預設專案進行這項操作。
使用其他標準 Cloud 專案
您可以切換指令碼專案,讓專案使用不同的標準 Cloud 專案如果您的指令碼需要手動設定 Cloud 專案,您必須從預設專案切換至標準專案 專案。學習 如要進一步瞭解何時需要使用標準專案,請參閱 標準 Cloud 專案
切換至其他標準 Cloud 專案的影響
如果您將指令碼從預設專案或其他標準切換至其他標準 這個 API 會產生下列結果:
- 如果指令碼已啟用進階服務,則必須啟用 與 GCP 環境下的對應 API 新的 Cloud 專案您將失去任何與進階升級 服務瞭解如何啟用 API 在 Cloud 專案中,請參閱「啟用 Google Workspace API」。
- 如果指令碼使用內建的 Google 雲端硬碟服務,則必須開啟
標準 Cloud 專案中的 Drive API。
在標準 Cloud 專案中開啟 Drive API:
- 先前已授權指令碼的所有使用者都必須重新授權。於 大部分情況下,凡是先前已授權應用程式建立關聯的使用者 新專案也必須重新授權。
- 如果您的指令碼與 Google Workspace Marketplace 中的應用程式資訊相關聯,系統就不會將您的應用程式資訊、使用者和評論轉移至 新的專案您必須在新專案內建立應用程式資訊, 使用者必須重新安裝您的應用程式。如要瞭解如何建立新的 應用程式資訊,請參閱「發布應用程式」。
- 你無法將指令碼切換回預設專案。Apps Script 刪除 預設專案。
切換至其他標準 Cloud 專案
將指令碼的現有 Cloud 專案切換至其他專案 Cloud 專案,請按照下列步驟操作:
- 如果沒有合適的 Cloud 專案,請建立 按照「Create a project」(建立專案) 一節的說明操作 操作說明。設定一個令人難忘的專案名稱 您可以在 Google Cloud 控制台的「管理資源」頁面中找到該資源。Apps Script 會在下列情況使用這個名稱: 要求使用者授權指令碼
- 如要使用現有專案,請開啟 Google Cloud 控制台的「管理資源」頁面 找到要使用的現有專案您必須具備 專案瀏覽器和 OAuth 設定編輯者角色,或具備同等角色 權限 專案。無法使用應用程式自動建立的專案 。
- 判定 Cloud 專案的專案編號。
- 開啟要取代 Cloud 專案的指令碼。
- 按一下左側的「專案設定」。 。
- 在「Google Cloud Platform (GCP) Project」(Google Cloud Platform (GCP) 專案) 下方,按一下 [變更專案]。
- 輸入新的專案編號,然後按一下「設定專案」。
雲端專案與共用雲端硬碟
共用雲端硬碟 (舊稱「團隊雲端硬碟」) 提供 可供雲端硬碟使用者透過 Apps Script 協作的共用聊天室 專案和雲端硬碟文件共用雲端硬碟對於開發應用程式 加入團隊的指令碼、外掛程式和網頁應用程式 您可對舊有預設 Cloud 專案執行哪些操作
以下限制清單說明 Cloud 專案的互動方式 共用雲端硬碟:
- 如果您的指令碼專案使用標準專案,則不會 當指令碼專案位於共用雲端硬碟時,會受到其他限制。
- 如果指令碼專案使用在 2019 年 4 月 8 日之後, 專案位於共用雲端硬碟中
- 如果您的指令碼專案使用
2019 年 4 月 8 日,指令碼適用下列限制
專案位於共用雲端硬碟中:
- 您無法透過 Apps Script UI 存取預設專案,或是 Google Cloud 控制台。這項限制會導致你無法 需要直接存取專案的動作。
- 您無法啟用進階服務。 如要啟用進階服務,請切換至標準服務 專案。
- 當您將現有的 Apps Script 專案移至共用雲端硬碟時,Google 會限制預設 Cloud 專案的存取權。你仍然可以 如果您在移動之前擁有存取權,則會存取預設專案。適用對象 例如 如果您在「我的雲端硬碟」資料夾中建立了指令碼,後來移動了位置 移至共用雲端硬碟,您仍然可以存取指令碼的 Cloud 專案共用雲端硬碟中的協作者可能無法查看檔案。
- 指令碼會保留先前使用的 Cloud 專案名稱 已移至 或共用雲端硬碟即使您變更共用雲端硬碟的專案名稱, 授權指令碼的使用者仍會在授權中看到舊名稱 對話方塊
為避免對舊版指令碼實施上述限制, 切換至標準專案。
取得 Apps Script Cloud 專案清單
如果您的「resourcemanager.projects.list
」權限
機構的 Apps Script 專案資料夾,您可以查看
資料夾中的預設 Apps Script Cloud 專案。
- 開啟 Google Cloud 控制台「管理資源」頁面。
- 複製「Apps Script」資料夾旁邊的 ID。
- 依序按一下「篩選器」>「父項 ID」然後貼上。 Apps Script 資料夾 ID。
刪除 Apps Script Cloud 專案
如要刪除 Apps Script Cloud 專案,請按照取得 Apps Script Cloud 專案清單 選取要刪除的專案,然後按一下 刪除:
如要使用「gcloud
」刪除 Apps Script 專案,請使用以下應用程式
指令
gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID
如要進一步瞭解如何刪除 Cloud 專案,請參閱「關閉」 (刪除) 專案。