Google Cloud 專案

每個 Apps Script 專案都會使用 Google Cloud 管理授權、進階服務和其他詳細資料。為設定及管理這些設定,每個 Apps Script 專案都會與 Google Cloud 專案建立關聯。指令碼專案可以使用 Apps Script 自動建立的預設專案,或是您自行建立的標準專案。一般來說,預設專案適合日常使用或 但您應該針對標準專案 較為複雜、商業品質,或者您想發布的內容

您可以從預設專案切換至標準專案 但無法改回使用預設專案。最好 ,選取指令碼在開發初期使用的 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

查看或更新預設的雲端專案

大多數使用者無法直接在 Google Cloud 控制台 存取 Google Cloud 控制台如果您是管理員,請參閱「查看預設 Google Cloud 專案」。

如果您是在 2019 年 4 月 8 日前建立指令碼專案,您可以使用 您可以在 Google Cloud 控制台中存取的預設專案如要使用 預設專案,請前往指令碼專案的設定,再按一下專案 號碼。

刪除預設的 Cloud 專案

如果您是管理員,可以像刪除標準 Cloud 專案一樣刪除預設 Cloud 專案。請參閱「刪除 Apps Script Cloud 專案」。

如果您不是管理員,就無法刪除預設專案。不過,在下列情況下,Apps Script 會刪除預設專案:

  • 如果您刪除指令碼專案或切換為使用標準專案,Apps Script 會刪除附加至指令碼的預設專案,以及其中包含的任何設定或資訊。
  • 如果指令碼未執行超過 180 天,Apps Script 則會刪除相關聯的預設專案如果指令碼的執行位置晚於 Apps Script 會刪除其預設專案,而 Apps Script 會為 指令碼

標準 Cloud 專案

對大部分的指令碼專案而言,預設 Cloud 專案是最佳選擇 除非您需要手動設定專案 在這些情況下,您必須 將指令碼專案改為使用標準專案

以下各節說明 Apps Script 需要使用標準專案的時機、 專案的屬性及常見工作您只能在標準專案中執行下列工作。

Apps Script 需要標準 Cloud 專案的情況

如遇下列情況,您必須使用標準專案:

標準 Cloud 專案屬性

標準專案的屬性如下:

  • 您可以直接存取專案的所有 Google Cloud 設定 使用 Google Cloud 控制台設定。這樣一來,您就能啟用 API、調整授權憑證,以及設定其他詳細資料。
  • 刪除指令碼專案或將專案切換為 使用其他標準專案,原始標準專案仍然存在,且可以 重複使用
  • 當您啟用進階服務時 如果要使用指令碼專案,您必須在指令碼專案中手動啟用對應的 API 標準專案
  • 多個指令碼專案和其他應用程式可以共用同一個 標準專案如果您打算發布指令碼專案 加入 Google Workspace Marketplace 做為外掛程式 則需要有專屬的標準專案已發布的應用程式無法分享 與其他應用程式的雲端專案搭配使用
  • 如要使用其他應用程式的指令碼專案執行函式 Apps Script API 的 scripts.run 方法, 指令碼專案和呼叫應用程式必須共用相同的標準 專案。
  • 當 Apps Script 要求使用者授權使用標準的指令碼時 專案時,Cloud 專案名稱會用於識別指令碼 (而非 指令碼專案名稱)。因此,請務必設定適當的 Cloud 專案名稱。

存取標準 Cloud 專案

如要存取與指令碼相關聯的標準專案,請按照下列步驟操作: 專案,請按照下列步驟操作:

  1. 開啟 Apps Script 專案。
  2. 按一下左側的「專案設定」圖示
  3. 在「Google Cloud Platform (GCP) Project」(Google Cloud Platform (GCP) 專案) 下方,按一下專案編號。

您也可以直接在 Google Cloud 控制台的「管理資源」頁面中找到標準專案。

在標準 Cloud 專案中啟用 API

Apps Script 應用程式經常需要存取其他 Google API。方法如下 您必須在相應的 Cloud 專案中啟用 API。 請按照下列步驟啟用 API:

  1. 開啟 Cloud 專案
  2. 按一下「選單」圖示 > API 與服務
  3. 點選「啟用 API 和服務」
  4. 在搜尋框中輸入要啟用的 API,然後按下 Enter 鍵。
  5. 在搜尋結果中點選 API,然後按一下「啟用」來啟用 為這個 Cloud 專案啟用 API

系統可能會提示您接受 Google APIGoogle Cloud:詳閱條款 接受條款之前,請務必仔細確認。

視應用程式而定,您可能還需要在「API 與服務」資訊主頁中選取 API,以便設定 API。

判定 ID 和標準的 Cloud 專案數量

所有 Cloud 專案都有專案名稱、專案 ID 和專案編號。有時,您必須具備這些 ID,才能設定服務或完成其他工作。

如要判斷標準專案的 ID 和編號,請按照下列步驟操作:

  1. 開啟 Cloud 專案
  2. 按一下右上方的「更多」圖示 > [專案設定]。
  3. 在隨即顯示的「Settings」面板中,查看「Project name」、「Project ID」和「Project number」。「專案編號」只包含 專案 ID 則為英數字元。您可以編輯專案名稱,系統會在授權提示中向使用者顯示這項資訊。

查看 Google Cloud 記錄檔與Google Cloud 控制台中的錯誤報告

如果您為指令碼專案使用 Google Cloud 記錄錯誤回報,可以按照下列步驟在 Google Cloud 控制台中查看這些記錄和報表:

  1. 開啟 Cloud 專案
  2. 按一下「選單」圖示
  3. 向下捲動至「操作」部分,然後依序點選「Logging」>「記錄檔探索工具」
  4. 如要查看錯誤報告,請向下捲動至「作業」部分 然後點選「Error Reporting」。如果系統提示 設定錯誤報告,表示您的指令碼專案並未 並記錄所有例外狀況。

使用需要 OAuth 的服務時,Google 會提示使用者授權這些服務。您可以透過 OAuth 同意畫面設定,設定 Google 向使用者顯示的部分資訊,例如應用程式名稱和服務條款網址。

預設 Cloud 專案會自動從 Apps Script 專案詳細資料;無法調整這些設定 採用標準 Cloud 專案後 可以自訂這項資訊你可以設定指令碼的同意聲明 方法如下:

  1. 開啟 Cloud 專案
  2. 按一下「選單」圖示 > API 與服務 >「憑證」
  3. 按一下 [Configure consent screen] (設定同意畫面)。
  4. 填寫同意畫面工作流程的各個部分。
  5. 如要記錄工作流程中每個階段的變更,請按一下 儲存並繼續

建立 OAuth 憑證

Apps Script 通常會為指令碼使用的服務設定 OAuth。對於某些應用程式,您必須建立額外的 OAuth 憑證 (用戶端 ID 和用戶端密鑰)。您只能對標準專案執行這項操作。

如要為指令碼專案建立用戶端 ID 和用戶端密鑰,請執行 包括:

  1. 開啟 Cloud 專案
  2. 依序按一下「選單」圖示 >「API 和服務」>「憑證」
  3. 按一下「建立憑證」> OAuth 用戶端 ID
  4. 在「應用程式類型」下方選取應用程式類型,然後 視需要填寫結果表單。完成後,點選「建立」
  5. 在畫面上顯示的對話方塊中,按一下「Download JSON」。你可以 使用這個檔案設定 OAuth

為標準 Cloud 專案新增其他擁有者

您可以在標準專案中新增其他擁有者或其他角色。 如果您要協作處理專案 團隊隨時都能存取指令碼專案的 Google Cloud 設定。

如要在標準專案中新增其他擁有者或其他角色,請按照下列步驟操作: 追蹤。您必須具備專案的編輯權限,才能進行下列任何變更:

  1. 決定協作者的身分。我們建議您 建立或使用現有的 Google 群組。你可以 您也可以在協作者清單中指定網域,納入該協作者清單中的所有使用者 網域。
  2. 開啟指令碼的 Cloud 專案
  3. 按一下「選單」圖示 > IAM 與管理員 >「身分與存取權管理」IAM
  4. 按一下頂端的「新增」
  5. 按照畫面上的指示新增一或多位新成員, 授予 Cloud 專案角色新增個別電子郵件地址、Google 網路論壇或 視為新成員
  6. 按一下 [儲存]

使用單一 Cloud 專案將多個指令碼分組

您可以讓多個 Apps Script 專案共用相同的標準 Cloud 專案如要這麼做,請建立標準專案 每個指令碼專案切換 以便使用。您無法對預設專案執行這項操作。

使用其他標準 Cloud 專案

您可以切換指令碼專案,讓專案使用不同的標準 Cloud 專案如果您的指令碼需要手動設定 Cloud 專案,您必須從預設專案切換至標準專案 專案。學習 如要進一步瞭解何時需要使用標準專案,請參閱 標準 Cloud 專案

切換至其他標準 Cloud 專案的影響

如果您將指令碼從預設專案或其他標準切換至其他標準 這個 API 會產生下列結果:

  • 如果您為指令碼啟用進階服務,則必須在新 Cloud 專案中開啟相應的 API。您將失去任何與進階升級 服務瞭解如何啟用 API 在 Cloud 專案中,請參閱「啟用 Google Workspace API」。
  • 如果指令碼使用內建的 Google 雲端硬碟服務,您必須在標準 Cloud 專案中開啟 Drive API。

    在標準 Cloud 專案中開啟 Drive API:

    啟用 Drive API

  • 先前已授權指令碼的所有使用者都必須重新授權。於 大部分情況下,凡是先前已授權應用程式建立關聯的使用者 新專案也必須重新授權。
  • 如果您的指令碼與 Google Workspace Marketplace 中的應用程式資訊相關聯,系統就不會將您的應用程式資訊、使用者和評論轉移至 新的專案您必須在新專案中建立應用程式資訊,且使用者必須重新安裝您的應用程式。如要瞭解如何建立新的應用程式資訊,請參閱「發布應用程式」。
  • 您無法將指令碼切換回預設專案。Apps Script 刪除 預設專案。

切換至其他標準 Cloud 專案

將指令碼的現有 Cloud 專案切換至其他專案 Cloud 專案,請按照下列步驟操作:

  1. 如果您沒有合適的 Cloud 專案,請按照「建立專案」中的操作說明建立專案。設定一個令人難忘的專案名稱 您可以在 Google Cloud 控制台的「管理資源」頁面中找到該資源。Apps Script 會在下列情況使用這個名稱: 要求使用者授權指令碼
  2. 如要使用現有專案,請開啟 Google Cloud 控制台的「管理資源」頁面 找到要使用的現有專案您必須具備 專案瀏覽器和 OAuth 設定編輯者角色,或具備同等角色 權限 專案。您無法使用由 Apps Script 自動建立的專案。
  3. 判定 Cloud 專案的專案編號
  4. 開啟要取代 Cloud 專案的指令碼。
  5. 按一下左側的「專案設定」
  6. 在「Google Cloud Platform (GCP) 專案」下方,按一下「變更專案」
  7. 輸入新的專案編號,然後按一下「設定專案」

雲端專案和共用雲端硬碟

共用雲端硬碟 (舊稱「團隊雲端硬碟」) 提供 可供雲端硬碟使用者透過 Apps Script 協作的共用聊天室 專案和雲端硬碟文件共用雲端硬碟對於開發應用程式 加入團隊的指令碼、外掛程式和網頁應用程式 您可對舊有預設 Cloud 專案執行哪些操作

以下限制清單說明 Cloud 專案的互動方式 共用雲端硬碟:

  • 如果您的指令碼專案使用標準專案,則不會 當指令碼專案位於共用雲端硬碟時,會受到其他限制。
  • 如果指令碼專案使用在 2019 年 4 月 8 日之後, 專案位於共用雲端硬碟中
  • 如果您的指令碼專案使用 2019 年 4 月 8 日,指令碼適用下列限制 專案位於共用雲端硬碟中:
    1. 您無法透過 Apps Script UI 存取預設專案,或是 Google Cloud 控制台。這項限制會導致你無法 需要直接存取專案的動作
    2. 您無法啟用進階服務。如要啟用進階服務,請切換至標準服務 專案。
    3. 當您將現有的 Apps Script 專案移至共用雲端硬碟時,Google 會限制預設 Cloud 專案的存取權。你仍然可以 如果您在移動之前擁有存取權,則會存取預設專案。適用對象 例如 如果您在「我的雲端硬碟」資料夾中建立了指令碼,後來移動了位置 移至共用雲端硬碟,您仍然可以存取指令碼的 Cloud 專案共用雲端硬碟中的協作者可能無法查看檔案。
    4. 指令碼會保留先前使用的 Cloud 專案名稱 已移至 或共用雲端硬碟即使您變更共用雲端硬碟的專案名稱, 授權指令碼的使用者仍會在授權中看到舊名稱 對話方塊

為避免對舊版指令碼實施上述限制, 切換至標準專案

取得 Apps Script Cloud 專案清單

如果您的「resourcemanager.projects.list」權限 機構的 Apps Script 專案資料夾,您可以查看 資料夾中的預設 Apps Script Cloud 專案。

  1. 開啟 Google Cloud 控制台「管理資源」頁面
  2. 複製「Apps Script」資料夾旁的 ID。
  3. 依序按一下「篩選器」>「父項 ID」然後貼上。 Apps Script 資料夾 ID。

刪除 Apps Script Cloud 專案

如要刪除 Apps Script Cloud 專案,請按照「取得 Apps Script Cloud 專案清單」一節的步驟操作,選取要刪除的專案,然後按一下「Delete」

如要使用「gcloud」刪除 Apps Script 專案,請使用以下應用程式 指令。

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID

如要進一步瞭解如何刪除 Cloud 專案,請參閱「關閉」 (刪除) 專案