程式設計層級:中級
時間長度:30 分鐘
專案類型:Google Workspace 外掛程式
目標
- 瞭解解決方案的功能。
- 瞭解 Apps Script 服務在 解決方案
- 設定環境。
- 設定指令碼。
- 執行指令碼。
認識這項解決方案
您可以手動將試算表的 Google 試算表巨集複製到其他試算表 不僅耗時又容易出錯這個 Google Workspace 外掛程式會自動安裝 複製指令碼專案,並附加到使用者指定的試算表。儘管 這項解決方案著重於試算表巨集 並分享任何容器繫結指令碼
運作方式
指令碼會複製與 原始試算表並建立重複的 Apps Script 專案 繫結至使用者指定的試算表。
Apps Script 服務
這項解決方案使用下列服務:
- 網址擷取服務:連結至應用程式 使用 Script API 複製來源專案並建立副本。
- 指令碼服務:授權 Apps Script 避免系統顯示第二個授權提示。
- 試算表服務:開啟目標 新增複製的 Apps Script 專案。
- 資訊卡服務:建立外掛程式的使用者介面。
必要條件
如要使用這個範例,您必須具備下列先決條件:
- Google 帳戶 (Google Workspace 帳戶可能會 需要管理員核准)。
可存取網際網路的網路瀏覽器。
Google Apps Script API 開啟於 Apps Script 資訊主頁設定。
設定環境
在 Google Cloud 控制台中開啟 Cloud 專案
如果沒有開啟,請開啟您要使用的 Cloud 專案 定義:
- 在 Google Cloud 控制台中,前往「選取專案」頁面。
- 選取要使用的 Google Cloud 專案。或是按一下「建立專案」,然後按照畫面上的指示操作。如要建立 Google Cloud 專案,您可能需要開啟該專案的計費功能。
開啟 Google Apps Script API
本快速入門導覽課程會使用 Google Apps Script API。
您必須先在 Google Cloud 專案中啟用這些 Google API,才能使用這些 API。 您可以在單一 Google Cloud 專案中啟用一或多個 API。在 Cloud 專案中,開啟 Google Apps Script API。
設定 OAuth 同意畫面
必須為 Google Workspace 外掛程式設定同意畫面。設定中 您外掛程式的 OAuth 同意畫面會定義 Google 向使用者顯示
- 在 Google Cloud 控制台中,前往「選單」圖示 > API 與服務 >「OAuth 同意畫面」。
- 在「使用者類型」部分選取「內部」,然後按一下「建立」。
- 填寫應用程式註冊表單,然後按一下「儲存並繼續」。
您現在可以略過新增範圍的步驟,然後按一下「儲存並繼續」。 日後您可以製作並使用應用程式 Google Workspace 機構,您必須將「使用者類型」變更為「外部」, 新增應用程式所需的授權範圍。
- 查看應用程式註冊摘要。如要修改資訊,請按一下「編輯」。如果應用程式 註冊看起來沒有問題,請按一下 [返回資訊主頁]。
設定指令碼
建立 Apps Script 專案
- 按一下下方按鈕開啟共用巨集
Apps Script 專案。
開啟專案 - 按一下「總覽」圖示 。
- 在總覽頁面中,按一下「建立副本」圖示
。
複製 Cloud 專案編號
- 在 Google Cloud 控制台中,前往「選單」圖示 > IAM 與管理員 >「設定」。
- 複製「Project number」欄位中的值。
設定 Apps Script 專案的 Cloud 專案
- 在複製的 Apps Script 專案中,
按一下「Project Settings」圖示
。
- 在「Google Cloud Platform (GCP) Project」(Google Cloud Platform (GCP) 專案) 下方,按一下 [變更專案]。
- 在「GCP 專案編號」中,貼上 Google Cloud 專案編號。
- 按一下「設定專案」。
安裝測試部署作業
- 在複製的 Apps Script 專案中按一下「編輯器」 。
- 開啟
UI.gs
檔案,然後按一下「Run」。當系統提示時,請授權 指令碼 - 依序點選「部署」>「測試部署作業」。
- 依序點選「安裝」>「完成」。
取得巨集指令碼和試算表資訊
- 開啟含有巨集且你具備相關權限的試算表 編輯。如要使用範例試算表,請複製範例巨集 試算表。
- 依序按一下「擴充功能」>「Apps Script」。
- 在 Apps Script 專案中,按一下
專案設定
。
- 按一下指令碼 ID 下方的「複製」。
- 一邊設定指令碼 ID,供後續步驟使用。
- 開啟或建立新的試算表以加入巨集。您必須 有權編輯這份試算表。
- 複製試算表網址並設為在後續步驟中使用。
執行指令碼
確認資訊主頁設定中的 Google Apps Script API 已開啟。按照下列各節中的步驟執行指令碼。
複製巨集
- 在 Google 試算表的右側欄中,開啟「分享巨集」外掛程式
。
- 在「來源巨集」下方,貼上指令碼 ID。
- 在「目標試算表」下方貼上試算表網址。
- 按一下「共用巨集」。
- 按一下「授予存取權」並授權外掛程式。
- 重複步驟 2 到 4。
開啟複製的巨集
- 開啟您複製巨集的試算表 (如果尚未開啟)。
- 依序按一下「擴充功能」>「Apps Script」。
- 如果找不到複製的 Apps Script 專案,請確認 已在資訊主頁啟用 Google Apps Script API 設定 ,並重複「複製巨集」下方列出的步驟。
查看程式碼
如要查看這個解決方案的 Apps Script 程式碼,請按一下 查看原始碼如下:
查看原始碼
Code.gs
UI.gs
appsscript.json
貢獻者
這個範例是由 Google 在 Google Developers 專家的協助下維護。