初心者でもできる！Google Apps Scriptでスプレッドシートのセルを読み込む方法

2025.07.23

Googleスプレッドシートを使っていると、セルのデータを自動で取得したり、他のセルにコピーしたりしたい場面が出てきます。そんなときに便利なのが、Google Apps Script（GAS）です。今回は、GASを使ってスプレッドシートのセルを読み込む方法を、初心者の方にもわかりやすく解説します。

セルの値を取得する基本の流れ
セルの指定方法と注意点
セルの値を他のセルにコピーする方法
よくある質問や疑問
今すぐ解決したい！どうしたらいい？
まとめ

セルの値を取得する基本の流れ

Googleスプレッドシートのイメージ

まずは、GASでセルの値を取得する基本的な流れを見てみましょう。

スプレッドシートを開く操作したいスプレッドシートを指定します。
シートを選択するその中から、操作したいシートを選びます。
セルを指定する値を取得したいセルを指定します。
値を取得する指定したセルの値を取得します。

例えば、セルの値を取得する場合、以下のようなコードになります。

javascript

function getCellValue() {

  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();

  var value = sheet.getRange('').getValue();

  Logger.log(value);

}

このコードを実行すると、セルの値がログに表示されます。

セルの指定方法と注意点

セルを指定する方法には、いくつかのバリエーションがあります。

セル番地で指定`getRange(”)`のように、セルの番地を文字列で指定します。
行番号と列番号で指定`getRange(1, 1)`のように、行番号と列番号を数字で指定します。セルは1行1列目にあたります。
範囲を指定`getRange(1, 1, 3, 2)`のように、開始行・開始列・行数・列数を指定して、複数のセルを取得します。

注意点として、セルの範囲を指定する場合、`getValue()`ではなく`getValues()`を使う必要があります。`getValues()`は、指定した範囲のセルの値を2次元配列で取得します。

javascript

function getRangeValues() {

  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();

  var values = sheet.getRange(1, 1, 3, 2).getValues();

  Logger.log(values);

}

このコードを実行すると、からB3までのセルの値が2次元配列としてログに表示されます。

セルの値を他のセルにコピーする方法

取得したセルの値を、別のセルにコピーすることもできます。例えば、セルの値をB1セルにコピーする場合、以下のようなコードになります。

javascript

function copyCellValue() {

  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();

  var value = sheet.getRange('').getValue();

  sheet.getRange('B1').setValue(value);

}

このコードを実行すると、セルの値がB1セルにコピーされます。