【GAS】Google Apps Scriptで、セルの値を取得する方法 – getRange()

スプレッドシート内のセルの値を、Google Apps Scriptで取得する方法を説明します。

セルの値の取得には、getRange()メソッドをもちいます。

サンプルのスプレッドシート

下記のようなサンプルデータをもつシートで説明します。

getRange()は、sheetオブジェクトのメソッドになります。

まずsheetオブジェクトを定義します。

var sheet = SpreadsheetApp.getActiveSheet();  /アクティブなシート取得

getRange()メソッド

引数の指定方法が複数あります。それぞれ説明していきます。

getRange(row, column)

・ getRange(row, colum) – Google Apps Script マニュアル 

列番号と行番号を指定し、該当するセルを１つ取得します。

var range = sheet.getRange(1, 2);  //セル取得
var data = range.getValue();       //セルの値を取得
Browser.msgBox(data);              //モーダルダイアログに表示

colとrowの関係は下記です。

直訳すると col = column = 柱 で、列番号になります。

サンプルコードを実行すると、 1002 が表示されます。

getRange(row, column, numRows)

・getRange(row, colum, numRows) – Google Apps Script マニュアル

第３引数 numRows が追加されました。

numRowsには、取得するセルの行数を指定します。

サンプルコード

  var range = sheet.getRange(2, 2, 3);
  var data = range.getValues();
  Browser.msgBox(data)

第１、２引数でセルの位置を設定し、第３引数でセルの取得範囲を設定します。

取得範囲が複数セルの場合、getValuesメソッドですべての値を取得することができます。

getRange(row, column, numRows, numColumns)

・getRange(row, column, numRows, numColumns)- Google Apps Script マニュアル

第４引数 numColumns が追加されました。

第１、２引数でセルの取得開始位置を指定し、第３で取得する行数、第４引数で取得する列数を指定します。

  var range = sheet.getRange(2, 2, 3, 2);
  var data = range.getValues();
  Browser.msgBox(data)

まとめ

rowとcolの関係も混同しがちになるので整理して確認しましょう。

関連記事:

【Google Apps Script】セルの内容をコピペできるように、メッセージダイアログに改行して表示する【スプレッドシート】 【請求書】Googleスプレッドシートで請求書を自動生成するツールを公開しました【Google Workspace】