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

Google 試算表巨集

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

錄製巨集時，Google 試算表會自動建立 Apps Script 複製巨集步驟的函式 (巨集函式)。巨集函式會新增至 Apps Script 專案 bound 已新增至工作表 (檔案名稱為 macros.gs)。如果已繫結至含有該名稱的工作表的專案檔案，或附加在 BigQuery 中Google 試算表也會自動更新指令碼專案 manifest，記錄名稱以及指派給巨集的鍵盤快速鍵

由於每個錄製的巨集都是在 Apps Script 中定義，因此直接在 Apps Script 編輯器中編輯。您甚至可以編寫從頭開始執行您曾經編寫的轉換為巨集

在 Apps Script 中建立巨集

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

或者，您也可以在 Apps Script 編輯器中建立巨集，方法是：步驟如下：

在 Google 試算表 UI 中，選取「擴充功能」圖示 > Apps Script 開啟指令碼繫結至 Apps Script 編輯器的工作表。
編寫巨集函式。巨集函式不應使用引數，並傳回沒有值。
編輯指令碼資訊清單建立巨集並連結至巨集函式。為負載平衡器指派專屬 ID 鍵盤快速鍵和名稱。
儲存指令碼專案。巨集就會出現在工作表中使用。
請在工作表中測試巨集函式，確認函式是否正常運作。

編輯巨集

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

在 Google 試算表 UI 中，選取「擴充功能」圖示 > 巨集 > [管理巨集]。
找出要編輯的巨集，然後選取 >編輯巨集。開啟複製到包含巨集函式的專案檔案。
編輯巨集函式以變更巨集行為。
儲存指令碼專案。巨集就會出現在工作表中使用。
請在工作表中測試巨集函式，確認函式是否正常運作。

以巨集的形式匯入函式

如果已經將指令碼「繫結」至工作表，您可以將指令碼中的函式匯入為新巨集，然後指派這個函式鍵盤快速鍵。方法如下：編輯資訊清單並在 sheets.macros[] 資源。

您也可以按照下列步驟，從試算表 UI：

在 Google 試算表 UI 中，選取「擴充功能」圖示 > 巨集 > 匯入。
從顯示的清單中選取函式，然後按一下「新增函式」。
選取即可關閉對話方塊。
依序選取「擴充功能」>「巨集」 > [管理巨集]。
在清單中找出您剛剛匯入的函式。指定專屬鍵盤巨集。您可以在這裡變更巨集名稱；名稱預設為函式名稱
按一下「更新」，儲存巨集設定。

巨集的資訊清單結構

下列資訊清單檔案程式碼片段為 manifest：定義 Google 試算表巨集。資訊清單的 sheets 區段會定義名稱和鍵盤快速鍵巨集和巨集函式名稱。

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

請參閱試算表巨集資訊清單資源。，進一步瞭解建構試算表巨集資訊清單的方式。

最佳做法

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

在輕量級巨集中，巨集的效能較佳。盡可能限制巨集採取的動作數量
巨集最適合用於需要重複執行的漫遊作業而且很少或完全沒有設定如要執行其他作業，請改用自訂選單項目。
請記得，巨集鍵盤快速鍵不得重複，且工作表一次只能有 10 個巨集與快速鍵。其他巨集只能在 Extensions > 中執行巨集選單。
對單一儲存格進行變更的巨集可套用於儲存格的值，方法是先選取整個範圍，然後再啟用巨集。也就是說，建立巨集來複製對預先定義的儲存格範圍執行相同作業

禁止事項

巨集功能有一些限制：

在已繫結的指令碼外使用巨集

巨集是在繫結至特定 Google 試算表的指令碼中定義。大型如果定義於獨立指令碼或網頁應用程式。

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

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

在指令碼庫中分配巨集

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

在 Google 試算表以外的地方使用巨集

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