建立及管理部署作業

Apps Script 專案部署作業是指令碼版本,可做為網頁應用程式、外掛程式或 API 執行檔使用。藉由建立和管理部署作業,您可以疊代程式碼、追蹤變更,以及控管使用者可存取的程式碼版本。

部署作業分為兩種類型:

  • 主要部署作業:一律與目前的專案程式碼同步處理。
  • 版本化部署作業:已連結至特定專案版本。

主要部署作業

首部署項目是目前的專案程式碼。建立 Apps Script 專案時,您會自動為該專案建立主要部署作業。

主要部署項目一律會與最近儲存的程式碼保持同步。舉例來說,如果您建立版本化部署作業然後修改程式碼,前置部署作業會反映這些變更,而版本化部署作業則維持不變。

使用主要部署作業測試程式碼。請勿將主要部署項目用於公開用途。

版本化部署作業

版本化部署作業會提供專案程式碼的特定版本。如此一來,當您對程式碼進行變更及改善時,使用者就能繼續使用可正常運作的版本。

發布應用程式供公開使用時,請一律使用版本化部署。您可以一次擁有多個有效的版本化部署作業。

重要事項:您無法轉移版本化部署作業的擁有權。如果您將指令碼專案的擁有權轉移給其他人,專案中現有版本化部署作業的擁有者不會改變。如果管理員刪除部署作業擁有者的帳戶,您可能會遇到部署作業的指令碼錯誤。

建立版本化部署作業

如要部署 Google Workspace 外掛程式、編輯器外掛程式、Google Chat 應用程式或 API 執行檔的版本,您必須先將 Apps Script 的 Google Cloud 專案關聯從預設專案切換為標準專案

如要建立版本化部署作業,請按照下列步驟操作:

  1. 開啟 Apps Script 專案。
  2. 依序按一下右上方的「部署」>「新增部署作業」
  3. 按一下「Select type」(選取類型) 旁的「Enable Deployment type」(啟用部署類型)
  4. 選取您要部署的部署類型。如果是 Google Workspace 外掛程式、編輯器外掛程式和 Google Chat 應用程式,請選取「外掛程式」
  5. 輸入部署作業的相關資訊,然後按一下「Deploy」(部署)

查看版本化部署作業

如要查看 Apps Script 專案的部署作業,請在頂端依序點選「部署」>「管理部署作業」

如要查看特定版本的代碼,請參閱「查看先前版本」。

編輯版本化部署作業

您可以編輯版本化部署作業,變更說明或版本。如要編輯部署作業,請按照下列步驟操作:

  1. 開啟 Apps Script 專案。
  2. 依序點選「部署」>「管理部署作業」
  3. 選取要變更的有效部署作業,然後按一下「編輯」圖示
  4. 進行變更,然後按一下「Deploy」(部署)

    如要編輯已封存的部署作業,您必須重新部署該部署作業,然後遵循上述步驟。

    如果您想將變更部署至專案程式碼,請建立新版本並編輯部署作業以使用該版本。凡是採用該部署項目的使用者都會自動使用新版本。

尋找部署 ID

每項部署作業都會自動產生相關聯的字串 ID。如要尋找這個 ID,請按照下列步驟操作:

  1. 開啟 Apps Script 專案。
  2. 依序點選右上方的「部署」>「管理部署作業」
  3. 選取進行中的部署作業以尋找其 ID。

    部署作業 ID 只會顯示在執行中的部署作業上。

測試部署作業

測試部署作業的方式取決於您建構的應用程式類型。

Google Workspace 外掛程式

如要測試 Google Workspace 外掛程式部署作業,請參閱「 測試 Google Workspace 外掛程式」一文。

編輯器外掛程式

如要測試編輯器外掛程式的部署作業,請參閱「測試編輯器外掛程式」。

網頁應用程式

如要測試網頁應用程式部署作業,請參閱「 測試網頁應用程式部署作業」。

Google Chat 應用程式

如要測試 Chat 應用程式的部署作業,您必須先 建立指令碼版本化部署作業,才能存取其部署作業 ID。

取得部署作業 ID 後,請按照步驟啟用 Google Chat API。在「設定」頁面的「權限」下方,僅指定您的電子郵件地址,以便安裝及測試應用程式。

API 執行檔

如要測試 API 執行檔部署作業,您必須先 建立版本化部署。建立部署作業後,請按照下列步驟操作:

  1. 在 Apps Script 專案右上方,依序按一下「部署」>「測試部署作業」
  2. 依序點選「選取類型」旁邊的「啟用部署類型」圖示 >「API 執行」。
  3. 複製並使用這個網址,以測試 API 執行檔部署項目。

封存版本化部署作業

您無法刪除版本化部署作業。不過,你可以改為封存這類郵件。

如何封存版本化部署作業:

  1. 開啟 Apps Script 專案。
  2. 依序點選「部署」>「管理部署作業」
  3. 選取您要封存的部署作業,然後按一下「Archive deployment」(封存部署作業)

重新部署已封存的部署作業

  1. 開啟 Apps Script 專案。
  2. 依序點選右上方的「部署」>「管理部署作業」
  3. 在左側的「已封存」下方,選取要重新部署的部署作業,然後依序點選「編輯」圖示 >「部署」