Google Apps Scriptでスプレッドシートのセルを取得する方法を初心者向けに解説

2025.07.23

Googleスプレッドシートを使っていると、「このセルの値を自動で取得したい」「別のセルにコピーしたい」といった場面が出てきます。そんなときに役立つのが、Google Apps Script（GAS）です。今回は、GASを使ってスプレッドシートのセルを取得する方法を、初心者の方にもわかりやすく解説します。

セルの取得方法基本の3つのメソッド
よくある質問や疑問
今すぐ解決したい！どうしたらいい？
まとめ

セルの取得方法基本の3つのメソッド

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

getValue()で1つのセルの値を取得

まずは、特定のセルから値を取得する方法です。例えば、セルに入力された「こんにちは」を取得したい場合、以下のように記述します。

javascript

function getCellValue() {

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

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

  Logger.log(value); // 実行ログに「こんにちは」と表示されます

}

このコードでは、`getRange(”)`でセルを指定し、`getValue()`でそのセルの値を取得しています。

getValues()で複数のセルの値を取得

次に、複数のセルから値を取得する方法です。例えば、からC3までの範囲の値を取得したい場合、以下のように記述します。

javascript

function getRangeValues() {

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

  const values = sheet.getRange('C3').getValues();

  Logger.log(values); // 実行ログに2次元配列として表示されます

}

このコードでは、`getRange(‘C3’)`でからC3までの範囲を指定し、`getValues()`でその範囲の値を2次元配列として取得しています。

getActiveCell()で現在選択されているセルの値を取得

最後に、現在選択されているセルから値を取得する方法です。例えば、ユーザーが選択したセルの値を取得したい場合、以下のように記述します。

javascript

function getActiveCellValue() {

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

  const activeCell = sheet.getActiveCell();

  const value = activeCell.getValue();

  Logger.log(value); // 実行ログに選択されているセルの値が表示されます

}

このコードでは、`getActiveCell()`で現在選択されているセルを取得し、`getValue()`でそのセルの値を取得しています。

よくある質問や疑問

Q1: getValue()とgetValues()の違いは何ですか？

セルのような1つのセルから値を取得する場合は`getValue()`を使用します。複数のセルから値を取得する場合は`getValues()`を使用します。`getValues()`は2次元配列を返すため、複数行・複数列のデータを一度に取得できます。

Q2: セルの値を取得した後、どのように活用できますか？

取得したセルの値は、別のセルに書き込んだり、条件分岐に利用したり、メール送信の内容に組み込んだりと、さまざまな用途に活用できます。

Q3: セルの値を変更する方法はありますか？

はい、`setValue()`メソッドを使用することで、セルの値を変更できます。例えば、セルに「こんにちは」と入力する場合、以下のように記述します。

javascript

function setCellValue() {

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

  sheet.getRange('').setValue('こんにちは');

}