【GAS】Google Apps ScriptでSpreadSheetの範囲指定とデータ取得系操作の基本を解説

const activeSpreadSheet = SpreadsheetApp.getActiveSpreadsheet(); // 現在のSpreadSheetを取得
const sheet = activeSpreadSheet.getSheetByName('テスト'); // シート(SpreadSheetの下のタブ名を指定)

// getValuesで取得したデータの例(2次元配列)
[ 
  [ 'A1', 'B1', 'C1', 'D1', 'E1' ],
  [ 'A2', 'B2', 'C2', 'D2', 'E2' ],
  [ 'A3', 'B3', 'C3', 'D3', 'E3' ]
]

const data = sheet.getDataRange().getValues();
console.log(data);

// 以下実行結果
[ [ 'A1', 'B1', 'C1', 'D1', 'E1' ],
  [ 'A2', 'B2', 'C2', 'D2', 'E2' ],
  [ 'A3', 'B3', 'C3', 'D3', 'E3' ],
  [ 'A4', 'B4', 'C4', 'D4', 'E4' ],
  [ 'A5', 'B5', 'C5', 'D5', 'E5' ],
  [ 'A6', 'B6', 'C6', 'D6', 'E6' ],
  [ 'A7', 'B7', 'C7', 'D7', 'E7' ],
  [ 'A8', 'B8', 'C8', 'D8', 'E8' ],
  [ 'A9', 'B9', 'C9', 'D9', 'E9' ],
  [ 'A10', 'B10', 'C10', 'D10', 'E10' ] ]

getRange(row(行), column(列) , numrows(行数の範囲), numcolumns(列数の範囲))

// 補足
列のAやBは、「A => 1」になり、「B => 2」になります。

const data = sheet.getRange("A1").getValue(); // A1
console.log(data);

// 以下実行結果
A1

const data = sheet.getRange(1, 2).getValue(); // B1
console.log(data);

// 以下実行結果
B1

const data = sheet.getRange(1, 2, 2).getValues(); // B1:B2
console.log(data);

// 以下実行結果
[ [ 'B1' ], [ 'B2' ] ]

const data = sheet.getRange(1, 2, 2, 2).getValues(); // B1:C2
console.log(data);

// 以下実行結果
[ [ 'B1', 'C1' ], [ 'B2', 'C2' ] ]

const data = sheet.getActiveRange().getValues();
console.log(data);

const data = sheet.getCurrentCell().getValue();
console.log(data);