Google Cloud 專案

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

每個 Apps Script 專案都使用 Google Cloud 來管理授權、進階服務和其他詳細資料。如要配置及管理這些設定,每個 Apps Script 專案都有相關聯的 Google Cloud 專案。您的指令碼專案可以使用 Apps Script 自動建立的預設專案,或由您自行建立標準專案。一般來說,預設專案適用於日常或簡易指令碼,但如果是標準、商業品質或您想發布的應用程式,應使用標準專案。

您隨時可以從預設專案切換至標準專案,但無法改回使用預設專案。最好選擇指令碼在開發初期使用的 Cloud 專案。日後切換時可能會造成資料複雜性,例如要求使用者重新授權。

預設 Cloud 專案

建立 Apps Script 專案時,Apps Script 會建立在背景運作的預設 Cloud 專案。

  • 大部分指令碼都不需要查看或調整這個預設專案。Apps Script 會處理必要的 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 控制台中直接尋找、檢視或編輯預設專案。如果您是管理員,請參閱查看預設 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 做為外掛程式,則其專案必須要有自己的標準專案。已發布的應用程式無法與其他應用程式共用 Cloud 專案。
  • 如要使用 Apps Script API 的 scripts.run 方法從其他應用程式執行指令碼專案中的函式,則指令碼專案和呼叫應用程式必須共用相同的標準專案。
  • 當 Apps Script 要求使用者授予使用標準專案的指令碼時,系統會使用 Cloud 專案名稱來識別指令碼 (而非指令碼專案名稱)。因此,請務必設定適當的 Cloud 專案名稱。

存取標準 Cloud 專案

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

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

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

在標準 Cloud 專案中啟用 API

Apps Script 應用程式通常必須存取其他 Google API。如要這麼做,您必須在對應的 Cloud 專案中啟用 API。 請按照下列步驟啟用 API:

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

系統可能會提示您接受 Google APIGoogle Cloud 的《服務條款》。接受《服務條款》前,請先詳閱《服務條款》。

視應用程式而定,您可能也需要在 API 和服務資訊主頁中選取 API 以進行設定。

確認標準 Cloud 專案的 ID 和編號

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

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

  1. 開啟 Cloud 專案
  2. 依序按一下右上角的「更多」圖示 > [專案設定]
  3. 在顯示的「Settings」(設定)面板中,查看專案名稱專案 ID專案編號。「Project number」(專案編號) 僅由數字組成,而「Project ID」(專案 ID) 為英數字元。您可以編輯專案名稱,在授權提示過程中向使用者顯示。

在 Google Cloud 控制台中查看 Google Cloud 記錄檔和錯誤報告

如果您在指令碼專案中使用 Google Cloud Logging錯誤報告,則可在 Google Cloud Console 中查看這些記錄和報告,步驟如下:

  1. 開啟 Cloud 專案
  2. 按一下「選單」圖示
  3. 向下捲動至「Operations」(作業) 部分,然後依序按一下 [Logging] (記錄) > [Logs Explorer] (記錄檔探索工具)。
  4. 如要查看錯誤報告,請向下捲動至「Operations」(作業) 部分,然後按一下 [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. 在「Application type」(應用程式類型) 下方,選取您的應用程式類型,然後視需要填寫產生的表單。完成後,請按一下 [建立]。
  5. 在畫面上出現的對話方塊中點選 [下載 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 專案的影響

如果您將指令碼從預設專案切換至其他標準專案,會發生以下效果:

  • 如果您已為指令碼啟用進階服務,您必須在新的 Cloud 專案中開啟對應的 API。與先前 Cloud 專案中的進階服務相關的所有資料都會遺失。要瞭解如何在 Cloud 專案中啟用 API,請參閱啟用 Google Workspace API
  • 先前已授權指令碼的所有使用者都必須重新授權。在大多數情況下,先前已授權與新專案相關聯的應用程式的所有使用者也必須重新授權。
  • 如果您的指令碼與 Google Workspace Marketplace 上的應用程式資訊相關聯,您的應用程式資訊、使用者和評論就不會轉移至新專案。您必須在新專案中建立應用程式資訊,且使用者必須重新安裝應用程式。如要瞭解如何建立新的應用程式資訊,請參閱發布應用程式
  • 您無法將指令碼切換回預設專案。在您將指令碼設定為使用標準專案之後,Apps Script 會刪除預設專案。

切換至其他標準 Cloud 專案

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

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

Cloud 專案和共用雲端硬碟

共用雲端硬碟 (原稱為團隊雲端硬碟) 提供共用空間,方便雲端硬碟使用者針對 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 專案清單

如果您擁有貴機構的 Apps Script 專案資料夾的 resourcemanager.projects.list 權限,就可以查看資料夾內所有標準和預設的 Apps Script Cloud 專案。

  1. 開啟 Google Cloud 控制台的管理資源頁面
  2. 複製「Apps 指令碼」資料夾旁邊的 ID。
  3. 按一下 [篩選器] > [父項 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 專案,請參閱關閉 (刪除) 專案一文。