【GAS入門#13】表全体のデータを一括取得!Range.getValues()の使い方と「2次元配列」を超わかりやすく解説

スプレッドシートのデータをGASで自動化する際、前回(第11回・第12回)学んだ getLastRow() や getLastColumn() を使うことで、表がどれだけ長く広がっていても「データが入っている最後の行と列」を自動で判別できるようになりましたね。

表の範囲(縦と横のサイズ)が掴めたら、次はいよいよ「その表に入っているすべてのデータをプログラムの中に読み込む」というステップに進みます。

データを取り出す命令といえば、第5回で学んだ Range.getValue() を思い出すかもしれません。しかし、表全体に対して getValue() を使うと、思わぬ罠にハマってしまいます。

そこで今回は、表全体のデータを一括で読み込み、処理速度を何十倍にも爆速化させる最重要メソッド Range.getValues()(複数形) を解説します!

初心者が最もつまずきやすい「2次元配列(にじげんはいれつ)」の仕組みから、実務で使えるコードの書き方、ハマりやすいエラーの対処法まで、どこよりも詳しく噛み砕いてお届けしますね。

1. なぜ getValue() を繰り返してはダメなの?getValues() が必要な理由

まず最初に、「なぜ getValues() を使わないといけないのか」という根本的な疑問を解決しておきましょう。

例えば、100行×4列(合計400セル)の表データがあるとします。この表からすべてのデータを読み取る場合、書き方は2パターン考えられます。

  1. getValue() をくり返し使って、1セルずつ400回読みに行く
  2. getValues() を使って、400セル分を1回でまとめて読み行く

実は、GASにおいて「スプレッドシートにデータを見に行く(通信する)」という処理は、非常に時間がかかる重い動作です。

  • getValue() を400回繰り返す場合:スプレッドシートとGASの間を400回往復することになります。結果として処理に数秒〜数十秒かかり、データ量が増えるとGASの制限時間(6分間)を超えてエラーで強制終了してしまいます。
  • getValues() を1回だけ使う場合:「この範囲のデータを全部ちょうだい!」と1回だけ頼み、一括でまとめて受け取ります。往復が1回で済むため、処理時間はわずか0.1秒以下で終わります。

身近な例えでイメージしてみよう!

  • getValue()(単数形):スーパーで買い物をするとき、リンゴを1個買うたびにレジへ走って会計し、また売り場に戻って人参を1個買ってレジに走る……という状態です。ものすごく効率が悪いですよね。
  • getValues()(複数形):買い物かごに欲しい食材を全部詰め込んで、最後にまとめて1回でレジで会計する状態です。

実務で大量のデータを扱うGASを作るなら、「データ取得は getValues() で1回で済ませる」 のが鉄則となります!

2. getValue() と getValues() の違いを徹底比較

単数形と複数形の仕様の違いを表で整理しました。

項目Range.getValue()(単数形)Range.getValues()(複数形)
読み取る範囲1つのセル(例: A1)複数のセル範囲(例: A1:D5)
返ってくる値の形単一のデータ(文字列、数値、日付など)2次元配列(表全体のデータ)
処理スピードセル数が多いと激重(タイムアウトの原因)1回の通信で終わるため爆速
使いどころ「特定の1つのセル」の値だけ見たいとき「表全体」を読み込んで処理したいとき

3. 超重要!「2次元配列(にじげんはいれつ)」ってなに?

getValues() を実行すると、取得したデータは「2次元配列」という形式でプログラムに保存されます。

ここがGAS学習者にとって最大の難所と言われているポイントですが、構造さえ分かってしまえば怖くありません!

1次元配列と2次元配列の違い

  • 通常の配列(1次元配列):データを横一列に並べた「単なるリスト」です。["フライドチキン", "和菓子", "100円惣菜"]
  • 2次元配列:「配列の中に、さらに配列が入っている」という二重の箱構造です。スプレッドシートの「行」と「列」の形が、そのままプログラムの中に再現されます。
[
  ["商品名", "カテゴリ", "価格"],       // 1行目のデータ(配列)
  ["フライドチキン", "ホットシェフ", 313], // 2行目のデータ(配列)
  ["くるみ大福", "和菓子", 162]        // 3行目のデータ(配列)
]

全体を大きく囲む外側のカッコ [ ] の中に、各「行」を表す小さなカッコ [ ] が順番に詰まっているイメージです。

4. 初心者が100%ハマる「0始まり(インデックス)」の考え方

2次元配列から特定のデータを取り出すとき、初心者が最も混乱するのが「番号の数え方」です。

スプレッドシートの行や列は「1行目、1列目」と 1から数えます よね。

しかし、プログラミングの世界(JavaScript / GAS)では、順番を 0から数える(インデックス)という絶対的なルールがあります。

スプレッドシートの位置と、配列の番号のズレ

スプレッドシートの見た目と、プログラム内での指定方法(配列[行][列])の対応関係を見てみましょう。

スプレッドシート上の位置内容2次元配列での指定方法理由・考え方
1行目・1列目(A1セル)"商品名"data[0][0]1行目(1-1=0)、1列目(1-1=0)
1行目・2列目(B1セル)"カテゴリ"data[0][1]1行目(1-1=0)、2列目(2-1=1)
2行目・1列目(A2セル)"フライドチキン"data[1][0]2行目(2-1=1)、1列目(1-1=0)
3行目・3列目(C3セル)162data[2][2]3行目(3-1=2)、3列目(3-1=2)

💡 ズレを解決する思考のコツ!

「スプレッドシートの行数・列数から、それぞれ 1 を引いた数字 を指定する!」と覚えておけば、迷うことがなくなりますよ。

5. STEP1:準備!「セコマのおすすめ商品リスト」を作ろう

それでは、実際に手を動かしながら getValues() を体験してみましょう!

今回は、道民のオアシスでおなじみセイコーマート(セコマ)の惣菜・おやつリストを題材にした練習用シートを作成します。

手順

  1. Googleスプレッドシートを新規作成し、ファイル名を「商品管理簿」にします。
  2. 画面下のシート名を「お気に入りリスト」に変更します。
  3. 以下のように表データを入力してください。
ABC
1商品名カテゴリ価格(税込)
2フライドチキンホットシェフ313
3くるみ大福和菓子162
4クリーミーチキンカツ丼ホットシェフ594
5プレーンヨーグルトリテールパートナー128

6. STEP2:【実践】getValues() で表全体のデータを読み込もう

データが準備できたら、GASを使って表全体のデータを一括取得するコードを書いていきます。

第11回・第12回で学んだ getLastRow()(最終行)と getLastColumn()(最終列)を組み合わせることで、将来データが増減してもコードを書き換える必要がない「自動拡張型」の完璧なプログラムが作れます!

1. コードを入力する

スプレッドシートのメニューバーから 「拡張機能」 > 「Apps Script」 を開き、最初から入っているコードを消して以下を貼り付けます。

function getAllSecomaData() {
  // ① 開いているスプレッドシートとシートを取得する
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();
  
  // ② データが存在する最後の行番号と列番号を自動取得する
  var lastRow = sheet.getLastRow();      // 今回は「5」が取れる
  var lastCol = sheet.getLastColumn();   // 今回は「3」が取れる
  
  // ③ 1行1列目(A1セル)を起点に、表全体の範囲(A1:C5)を指定する
  //    getRange(開始行, 開始列, 行数, 列数)
  var range = sheet.getRange(1, 1, lastRow, lastCol);
  
  // ④ 表全体のデータを一括取得する(2次元配列として保存される)
  var allData = range.getValues();
  
  // ⑤ 取得したデータ全体をログに出力して確認してみる
  Logger.log(allData);
}

2. コードの1行ずつ解説!

  • var lastRow = sheet.getLastRow();
    表にデータが入っている一番下の行番号(今回は5行目)を自動計算して取ってきます。
  • var lastCol = sheet.getLastColumn();
    データが入っている一番右の列番号(今回は3列目=C列)を自動計算して取ってきます。
  • sheet.getRange(1, 1, lastRow, lastCol)
    第4回で学んだ「数値指定の範囲選択」です。「1行目・1列目からスタートして、縦に5行分、横に3列分のエリアを掴む」という意味になります。
  • var allData = range.getValues();
    掴んだエリアに入っているデータを、まとめて1回でプログラム内の変数 allData に読み込みます。

3. 実行結果を確認する

コードを保存し、getAllSecomaData を実行してみましょう。

エディタ下の「実行ログ」に以下のように表示されれば大成功です!

情報 [
  ["商品名", "カテゴリ", "価格(税込)"],
  ["フライドチキン", "ホットシェフ", 313.0],
  ["くるみ大福", "和菓子", 162.0],
  ["クリーミーチキンカツ丼", "ホットシェフ", 594.0],
  ["プレーンヨーグルト", "リテールパートナー", 128.0]
]

スプレッドシートの表データが、そっくりそのまま2次元配列になってプログラムに取り込まれたことが確認できますね!

7. STEP3:読み込んだ2次元配列から「特定のピンポイントデータ」を取り出してみよう

表全体を allData という変数に読み込めたら、次はその中から欲しい部分だけをピンポイントで取り出してみましょう。

先ほどのコードの末尾に、以下のログ出力処理を追加して再度実行してみてください。

function getSpecificData() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();
  var allData = sheet.getRange(1, 1, sheet.getLastRow(), sheet.getLastColumn()).getValues();

  // 1. 見出し(ヘッダー)の「商品名」という文字(A1セル)を取り出す
  Logger.log("■ A1セルのデータ: " + allData[0][0]);

  // 2. 「くるみ大福」という商品名(A3セル)を取り出す
  //    スプレッドシートでは 3行目・1列目 ➡ 配列では [3-1][1-1] = [2][0]
  Logger.log("■ A3セルのデータ: " + allData[2][0]);

  // 3. 「クリーミーチキンカツ丼」の価格「594」(C4セル)を取り出す
  //    スプレッドシートでは 4行目・3列目 ➡ 配列では [4-1][3-1] = [3][2]
  Logger.log("■ C4セルのデータ: " + allData[3][2] + "円");
}

実行ログの結果

情報 ■ A1セルのデータ: 商品名
情報 ■ A3セルのデータ: くるみ大福
情報 ■ C4セルのデータ: 594円

このように、一度 getValues() で表全体を読み込んでしまえば、あとはスプレッドシートに通信しに行かなくても、プログラムの中で自由自在かつ超高速にデータを引っ張り出すことができます!

8. 初心者が必ず直面する「5大トラップ」と解決策

getValues() を使う際に、初心者がハマりやすいエラーや勘違いを5つまとめました。事前にチェックして、トラブルを未然に防ぎましょう!

トラップ1:1つのセルに対して間違えて getValues() を使ってしまう

  • よくある間違い:A1セル(1つのセル)の値だけを取りたいのに、間違えて getValues() を使ってしまう。
  • 起きる現象:取得できるデータが "商品名" ではなく [["商品名"]] という二重のカッコが付いた特殊な形になります。そのため、if (data == "商品名") と判定させようとしても不一致になり、プログラムが正しく動かなくなります。
  • 解決策:
    • セル1つだけなら ➡ getValue()(単数形)
    • 複数セル(表全体)なら ➡ getValues()(複数形)と明確に使い分けましょう!

トラップ2:単数形と複数形のタイポ(スペルミス)

  • よくある間違い:getValues() と書くべきところで、末尾の s を忘れて getValue() にしてしまう。
  • 起きる現象:範囲(例:A1:C5)に対して単数形の getValue() を使うと、エラーにはならず「一番左上のセル(A1)の値だけ」がぽつんと取得されます。「あれ?表全体のデータが取れていないぞ?」と悩む原因になります。

トラップ3:TypeError: Cannot read properties of undefined エラーが出る

  • よくある間違い:5行しかないデータに対して、間違えて allData[5][0] と指定してしまう。
  • 原因:5行目のデータはインデックス番号でいうと allData[4] です。allData[5] は「6行目」を指すことになり、データが存在しない(未定義=undefined)ためエラーが発生します。
  • 解決策:配列のインデックスは「行数 – 1」であることを常に意識しましょう!

トラップ4:見た目通りの文字(カンマや単位付き)が取れない

  • 起きる現象:スプレッドシート上で「¥162」や「2026/09/20」と表示されているのに、getValues() で取ると「162」という数値や「Sun Sep 20 2026 …」という英語の日付データになってしまう。
  • 原因:getValues() はセルに入っている「生のデータ(値)」を取得する命令だからです。
  • 解決策:もし画面に見えている通りの文字列(「¥162」など)をそのまま取得したい場合は、次回以降に学ぶ getDisplayValues() という別の命令を使用します。

トラップ5:getRange() の引数の順番を間違える

  • よくある間違い:sheet.getRange(lastRow, lastCol, 1, 1) のように順番を逆にしてしまう。
  • 正しい順番:getRange(開始行, 開始列, 行数, 列数) です。「どこからスタートして(開始行・開始列)、どれだけの大きさ(行数・列数)を掴むか」という順番をしっかり叩き込みましょう。

9. 今回のまとめと次回予告

今回は、表全体のデータを一瞬で取得する Range.getValues() と、その結果である 2次元配列 について詳しく解説しました。

今日の重要ポイント

  1. getValues() は複数セルの範囲から表データを一括で読み込む命令
  2. スプレッドシートとの通信が1回で済むため、処理速度が爆速になる
  3. 返ってくるデータは「2次元配列(行と列の二重箱)」になる
  4. 配列の番号指定は「0始まり」のため、行・列からそれぞれ 1 を引く
  5. getLastRow() と getLastColumn() を組み合わせて範囲を自動化するのが黄金パターン!

表全体のデータをプログラム内に取り込めるようになったら、次は「GAS側で計算・加工したデータを、スプレッドシートに一括で書き戻す」という操作がしたくなりますよね!

次回(第14回)は、今回学んだ getValues() の対となる超重要命令 Range.setValues() を解説します!

getValues() で取得 ➡ GASで一括加工 ➡ setValues() で一括書き込み、という実務で最も使われる最強の高速処理パターンを完成させましょう!ぜひお楽しみに!