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

擴充 Google 試算表

Google Apps Script 可讓你運用 Google 試算表做新奇有趣的事物。你可以使用 Apps Script 新增自訂選單。 Google 試算表對話方塊和側欄。此外，可讓您編寫自訂函式可以將試算表與其他 Google 服務，例如日曆、雲端硬碟和 Gmail。

大多數專為 Google 試算表設計的指令碼都會操控陣列與試算表中的儲存格、列和欄互動。如果不是 Codecademy 提供熟悉的 JavaScript 陣列陣列的絕佳訓練模組。 (請注意，這堂課程並非由 Google 製作，與 Google 無關)。

如要快速瞭解如何將 Apps Script 與 Google 試算表搭配使用，請參閱 5 分鐘的快速入門指南巨集、選單和自訂函式：

開始使用

Apps Script 包含特殊 API，可讓您透過程式建立、讀取和編輯 Google 試算表Apps Script 能以兩大方式與 Google 試算表互動：任何指令碼都能建立或修改試算表，前提是指令碼使用者必須適當權限或使用指令碼繫結至試算表，可讓指令碼以特殊的方式變更使用者介面或該試算表已開啟。如要建立繫結指令碼，請選取從以下擴充功能中存取「擴充功能」>「Apps Script」以及在 Google 試算表中建立專案計畫

試算表服務把 Google Google 試算表為格狀檢視，採用二維陣列。為了擷取資料必須能存取資料所在的試算表取得儲存資料的試算表範圍，然後取得輸入儲存格的值Apps Script 透過讀取結構化資料，並為這些物件建立 JavaScript 物件。

讀取資料

假設您有一份產品名稱和產品編號清單，如下圖所示。

以下範例說明如何擷取及記錄產品名稱和產品數字。

function logProductInfo() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();
  for (var i = 0; i < data.length; i++) {
    Logger.log('Product name: ' + data[i][0]);
    Logger.log('Product number: ' + data[i][1]);
  }
}

查看記錄

如要查看記錄的資料，請在指令碼編輯器頂端按一下 執行記錄。

寫入資料

如要將資料 (例如新的產品名稱和編號) 儲存至請將以下程式碼加到指令碼的結尾處。

function addProduct() {
  var sheet = SpreadsheetApp.getActiveSheet();
  sheet.appendRow(['Cotton Sweatshirt XL', 'css004']);
}

上述程式碼會在試算表底部附加新的一列，指定的值。如果您執行這個函式，會有一個新的資料列加到試算表。

自訂選單和使用者介面

您可以新增自訂選單、對話方塊和側欄如要瞭解建立選單的基本概念，請參閱選單指南。如要瞭解如何自訂對話方塊的內容，請參閱 HTML 服務指南。

你也可以在試算表；當使用者按一下圖片，或繪圖。詳情請參閱「Google 試算表中的圖片和繪圖」。

如果您計劃將自訂介面外掛程式，然後按照符合樣式指南，確保與以及 Google 試算表編輯器的樣式和版面配置

正在連線至 Google 表單

Apps Script 可讓您透過以下方式連結 Google 表單與 Google 試算表：表單和試算表服務。這項功能可以根據試算表中的資料自動建立 Google 表單。 Apps Script 還可讓您使用觸發條件，例如 onFormSubmit，在使用者回覆表單後執行特定動作。如要進一步瞭解如何連結 Google 試算表和 Google 表單，請前往「管理 Google 表單回應功能 5 分鐘快速入門導覽課程。

格式設定

Range 類別具有下列方法： setBackground(color) 來存取及修改儲存格或儲存格範圍的格式。下列範例顯示如何設定範圍的字型樣式：

function formatMySpreadsheet() {
  // Set the font style of the cells in the range of B2:C2 to be italic.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var cell = sheet.getRange('B2:C2');
  cell.setFontStyle('italic');
}

資料驗證

Apps Script 可讓您在 Google 試算表中存取現有的資料驗證規則也可以建立新規則以下範例說明如何設定資料驗證規則，儲存格只能包含 1 到 100 的數字。

function validateMySpreadsheet() {
  // Set a rule for the cell B4 to be a number between 1 and 100.
  var cell = SpreadsheetApp.getActive().getRange('B4');
  var rule = SpreadsheetApp.newDataValidation()
     .requireNumberBetween(1, 100)
     .setAllowInvalid(false)
     .setHelpText('Number must be between 1 and 100.')
     .build();
  cell.setDataValidation(rule);
}

如要進一步瞭解如何使用資料驗證規則，請參閱 SpreadsheetApp.newDataValidation()、 DataValidationBuilder, 和Range.setDataValidation(rule)

圖表

Apps Script 可讓您將圖表嵌入試算表中，以反映資料表中的資料，特定範圍的資料以下範例會產生內嵌長條圖儲存格 A1:B15 中有可繪製圖表的資料：

function newChart() {
  // Generate a chart representing the data in the range of A1:B15.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chart = sheet.newChart()
     .setChartType(Charts.ChartType.BAR)
     .addRange(sheet.getRange('A1:B15'))
     .setPosition(5, 5, 0, 0)
     .build();

  sheet.insertChart(chart);
}

如要進一步瞭解如何在試算表中嵌入圖表，請參閱「EmbeddedChart」和和特定圖表建構工具，例如 EmbeddedPieChartBuilder。

Google 試算表中的自訂函式

自訂函式與這類內建試算表函式 (例如 =SUM(A1:A5)) 函式的行為例如，您可以建立函式 in2mm()，可以將值從英寸轉換為公釐，然後使用您在試算表中輸入 =in2mm(A1) 或 =in2mm(10)，即可在儲存格。

如要進一步瞭解自訂函式，請試試選單和自訂函式 5 分鐘的快速入門導覽課程，或查看更多資訊自訂函式指南。

巨集

巨集是從 Google 試算表 UI 執行 Apps Script 程式碼的另一種方式。自訂功能與自訂功能不同，只要使用鍵盤快速鍵或「Google 試算表」選單若需更多資訊，請參閲 Google 試算表巨集。

Google 試算表外掛程式

外掛程式是經過特別封裝的 Apps Script 在 Google 試算表中執行且可安裝如何透過 Google 試算表外掛程式商店下載如果您已為 Google 試算表開發指令碼想要與全世界的人分享使用 Apps Script 時將指令碼發布為外掛程式，其他使用者就能從外掛程式商店安裝。

觸發條件

繫結至 Google 試算表檔案的指令碼可以使用簡單觸發條件，例如 onOpen() 和 onEdit() 即可在使用者編輯後自動回覆即可開啟或編輯該試算表。

就像簡單的觸發條件可安裝觸發條件讓 Google 試算表在特定事件發生時自動執行函式。可安裝然而，觸發條件比簡單的觸發條件和支援更具彈性以下事件：開啟、編輯、變更、表單提交和時間導向 (時鐘)。