初心者でもできる！Google Apps Scriptでスプレッドシートの値を取得する方法

2025.07.28

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

セルの値を取得する基本の方法
複数のセルの値を一度に取得する方法
セルの値を他のセルに書き込む方法
よくある質問や疑問
1. Q1: セルが空の場合、getValue()はどうなりますか？
2. Q2: 複数のセルの値を取得する場合、getValue()とgetValues()の違いは何ですか？
今すぐ解決したい！どうしたらいい？
まとめ

セルの値を取得する基本の方法

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

まずは、最も基本的な方法から始めましょう。例えば、スプレッドシートの「」セルに入力されている値を取得するには、以下のコードを使います。

javascript

function getCellValue() {

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

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

  Logger.log(value);

}

このコードを実行すると、スプレッドシートの「」セルの値が取得され、ログに表示されます。

複数のセルの値を一度に取得する方法

次に、複数のセルの値を一度に取得する方法を見てみましょう。例えば、「」から「C3」までの範囲の値を取得するには、以下のコードを使います。

javascript

function getMultipleValues() {

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

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

  Logger.log(values);

}

このコードを実行すると、指定した範囲の値が二次元配列として取得され、ログに表示されます。

セルの値を他のセルに書き込む方法

取得した値を他のセルに書き込むこともできます。例えば、「」セルの値を「B1」セルに書き込むには、以下のコードを使います。

javascript

function copyCellValue() {

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

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

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

}

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

よくある質問や疑問

Q1: セルが空の場合、getValue()はどうなりますか？

セルが空の場合、getValue()は空の文字列（””）を返します。空のセルをチェックするには、以下のように条件分岐を使います。

javascript

function checkEmptyCell() {

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

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

  if (value === "") {

    Logger.log("セルは空です");

  } else {

    Logger.log("セルの値は: " + value);

  }

}

Q2: 複数のセルの値を取得する場合、getValue()とgetValues()の違いは何ですか？

getValue(): 単一のセルの値を取得します。
– getValues(): 複数のセルの値を二次元配列として取得します。

例えば、「\:C3」の範囲を取得する場合、getValues()を使います。

javascript

function getRangeValues() {

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

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

  Logger.log(values);

}