SpreadsheetApp

【學習目標】

1. 學習使用GAS試算表類別提供的API，連接Google試算表。

2. 了解Google試算表四種不同API的連接方式與應用時機。

3. 依範例完成Goolge試算表儲存格的存取。

與試算表連結

API 試算表與指令碼分開 試算表中執行指令碼

openById() OK OK

openByUrl() OK OK

getActiveSheet No OK (只取得試算表的第一個工作表)

getActiveSpreadsheet() No OK (試算表中的所有工作表)

API的寫法

以將類別、方法、屬性宣告為變數方式來撰寫，程式較短且容易瞭解。

1.openById

function myFunction(){

  var ss = SpreadsheetApp.openById("Google試算表ID");

  var SheetName = ss.getSheetByName("sheet1");

  var range = SheetName.getRange(1,1); //取得儲存格A1

  range.setValue(123); //儲存格A1=123(數字)

}

2.openByUrl

function myFunction(){

  var ss = SpreadsheetApp.openByUrl("Google試算表URL");

  var SheetName = ss.getSheetByName("sheet1");

  var range = SheetName.getRange(2,2); //取得儲存格B2

  range.setValue("123"); //儲存格B2='123'(字串)

}

3.getActiveSheet

function myFunction(){

  SpreadsheetApp.getActiveSheet().getRange(2,2).setValue("123");

  //取得第一個(開啟中?)工作表儲存格B2，儲存格B2='123'(字串)，結果與上一個例子相同，不鼓勵用此寫法。

}

※.getRange(row: any, column: any): 

使用宣告變數方式來寫

function myFunction(){

  var ss = SpreadsheetApp.getActiveSheet();

  var range = ss.getRange(2,2); //取得第一個(開啟中?)工作表儲存格B2

  range.setValue("123"); //儲存格B2='123'(字串)

}

4.getActiveSpreadsheet

function myFunction(){

  var ss = SpreadsheetApp.getActiveSpreadsheet();

  var range = ss.getRange("B2"); //取得儲存格B2

  range.setValue("ABC"); //儲存格B2='ABC'

}

※.getRange(a1Notation: string): SpreadsheetApp.Range