本頁面由 Cloud Translation API 翻譯而成。

Google 試算表巨集

Google 試算表可讓您記錄巨集，複製您定義的特定一系列 UI 互動。錄製巨集後，您可以將巨集連結至 Ctrl+Alt+Shift+Number 表單中的鍵盤快速鍵。您可以使用該捷徑快速再次執行相同的巨集步驟，通常是在不同位置或針對不同的資料執行。您也可以透過 Google 試算表的「擴充功能」「巨集」選單啟用巨集。

錄製巨集時，Google 試算表會自動建立 Apps Script 函式 (即「巨集函式」)，用來複製巨集步驟。巨集函式會新增至與工作表繫結的 Apps Script 專案，並儲存在名為 macros.gs 的檔案中。如果專案檔案已繫結至該名稱的試算表，則會附加巨集函式。Google 試算表也會自動更新指令碼專案manifest，記錄指派給巨集的名稱和鍵盤快速鍵。

由於每個已錄製的巨集都會完全在 Apps Script 中定義，因此您可以直接在 Apps Script 編輯器中編輯巨集。您甚至可以在 Apps Script 中從頭開始編寫巨集，或是將已編寫的函式轉換為巨集。

在 Apps Script 中建立巨集

您可以使用 Apps Script 編寫的函式，並將其做為巨集函式。最簡單的方法是從 Google 試算表編輯器匯入現有函式。

或者，您也可以按照下列步驟在 Apps Script 編輯器中建立巨集：

在 Google 試算表 UI 中，依序選取「Extensions」「Apps Script」，即可在 Apps Script 編輯器中開啟與試算表繫結的指令碼。
編寫巨集函式。巨集函式不應接受任何引數，也不應傳回任何值。
編輯指令碼資訊清單，建立巨集並連結至巨集函式。為其指派不重複的鍵盤快速鍵和名稱。
儲存指令碼專案。這樣一來，即可在工作表中使用巨集。
測試工作表中的巨集函式，確認函式是否正常運作。

編輯巨集

如要編輯附加至工作表的巨集，請按照下列步驟操作：

在 Google 試算表 UI 中，依序選取「Extensions」>「Macros」>「Manage macros」。
找出要編輯的巨集，然後依序選取「」>「編輯巨集」。這會開啟 Apps Script 編輯器，並顯示含有巨集函式的專案檔案。
編輯巨集函式即可變更巨集行為。
儲存指令碼專案。這樣一來，即可在工作表中使用巨集。
測試工作表中的巨集函式，確認函式是否正常運作。

將函式匯入為巨集

如果試算表中已有繫結的指令碼，您可以import指令碼中的函式做為新巨集，然後指派鍵盤快速鍵。您可以編輯資訊清單檔案，並在 sheets.macros[] 屬性中新增其他元素。

或者，您也可以按照下列步驟，從 Google 試算表 UI 匯入函式做為巨集：

在 Google 試算表 UI 中，依序選取「Extensions」>「Macros」>「Import」。
從清單中選取函式，然後按一下「Add function」。
選取即可關閉對話方塊。
依序選取「擴充功能」>「巨集」>「管理巨集」。
在清單中找出剛剛匯入的函式。為巨集指派專屬的鍵盤快捷鍵。您也可以在此變更巨集名稱；名稱預設為函式的名稱。
按一下「更新」，儲存巨集設定。

巨集的資訊清單結構

以下資訊清單檔案範例程式碼片段，顯示manifest中定義 Google 試算表巨集的部分。資訊清單的 sheets 部分會定義指派給巨集的名稱和鍵盤快速鍵，以及巨集函式的名稱。

  {
    ...
    "sheets": {
      "macros": [{
        "menuName": "QuickRowSum",
        "functionName": "calculateRowSum",
        "defaultShortcut": "Ctrl+Alt+Shift+1"
      }, {
        "menuName": "Headerfy",
        "functionName": "updateToHeaderStyle",
        "defaultShortcut": "Ctrl+Alt+Shift+2"
      }]
    }
  }

如要進一步瞭解如何建構 Google 試算表巨集資訊清單，請參閱「Google 試算表巨集資訊清單資源」。

最佳做法

在 Apps Script 中建立或管理巨集時，建議您遵循下列規範。

輕量式巨集的效能會比較好。盡可能限制巨集執行的動作數量。
巨集最適合用於需要經常重複執行且幾乎不需要設定的機械式作業。如要執行其他操作，建議改用自訂選單項目。
請務必記住，巨集鍵盤快捷鍵必須是唯一的，且每個工作表一次只能有十個含有快捷鍵的巨集。任何其他巨集只能透過「擴充功能」>「巨集」選單執行。
如要將針對單一儲存格所做的變更套用至整個儲存格範圍，請先選取整個範圍，再啟用巨集。也就是說，通常不必建立巨集，在預先定義的儲存格範圍內重複相同的作業。

禁止事項

使用巨集時，請注意以下幾項限制：

在受限指令碼之外使用巨集

巨集是在綁定特定 Google 試算表的指令碼中定義。如果在獨立指令碼或網頁應用程式中定義巨集定義，系統會忽略這些定義。

在 Google 試算表外掛程式中定義巨集

您無法使用試算表外掛程式發布巨集定義。使用者會忽略試算表外掛專案中的任何巨集定義。

在指令碼程式庫中發布巨集

您無法使用 Apps Script 程式庫發布巨集定義。

在 Google 試算表以外使用巨集

巨集是 Google 試算表的功能，不適用於 Google 文件、表單或簡報。