【GAS入門#4】目的のマス目をピンポイント指定!Sheet.getRange()でセルや範囲を掴もう

前回(第3回)は、操作の土台となるスプレッドシートの中から、現在開かれているシートを特定する命令 Spreadsheet.getActiveSheet() について詳しく解説しました。

「家(スプレッドシートファイル)」に入り、「今いる部屋(シート)」を選ぶところまで進みましたね!

今回はその続きとして、GASでスプレッドシートを自動化する際の最重要テクニックである、目的のセルやセル範囲(マス目)をピンポイントで指定する命令 Sheet.getRange() をじっくり分かりやすく紐解いていきます!

STEP1:第3回の復習!「家・部屋・家具」の例えで理解する「Range」の位置づけ

コードを書き始める前に、まずは本連載でおなじみの「家・部屋・家具」の例えをおさらいしておきましょう。

GASでスプレッドシートのデータを操作するとき、プログラムは以下の階層構造で目的のデータを探しに行きます。

  • 【家】= スプレッドシートファイル全体(Spreadsheet)
    • 第2回で学んだ SpreadsheetApp.getActiveSpreadsheet() で取得した対象です。
  • 【部屋】= 個別のシートタブ(Sheet)
    • 第3回で学んだ ss.getActiveSheet() で取得した「中央区エリア」などのシートです。
  • 【家具】= セル・セル範囲(Range)★今回の主役!
    • 部屋の中にある「テーブル」や「棚のこの引き出し」のように、実際の値(文字や数値)が入っている1つひとつのマス目や、複数のマス目のまとまり(範囲)のことです。

前回までで「中央区エリア」という部屋に入るところまで成功しました。

今回は、その部屋の中にある「A2セルの店名」や「A2〜C5のデータ一覧」という特定の家具(Range)を手に取るステップに入ります!

STEP2:本日使う命令「Sheet.getRange()」とは?書き方の4パターンをマスターしよう

今回新しく覚える命令の文法と役割を確認しましょう。

Sheet.getRange()

(読み方:シート・ゲット・レンジ)

「getRange()」の役割

指定したシートオブジェクトに対して呼び出すことで、操作したいセルやセル範囲(Rangeオブジェクト)を取得する命令です。

実は getRange() には、状況に合わせて使い分けられる 4つの書き方(構文) があります。最初は戸惑うかもしれませんが、パターンを覚えてしまえばとっても簡単です!

パターン①:A1表記で1つのセルを指定する(直感的!)

var range = sheet.getRange("A2");
  • 説明:スプレッドシート上で見慣れている「A2」や「B5」といった形式を、ダブルクォーテーション "" で囲んで指定します。
  • メリット:コードを見たときに「どのセルを指しているか」が直感的に分かります。

パターン②:A1表記で複数のセル範囲を指定する

var range = sheet.getRange("A2:C5");
  • 説明:「A2からC5までの四角いエリア全体」を一括で指定します。
  • メリット:まとまった表データを一気に扱いたいときに便利です。

パターン③:行番号・列番号(数値)で1つのセルを指定する(プログラムで大活躍!)

var range = sheet.getRange(2, 1); // 2行目、1列目(=A2セル)
  • 説明: getRange(行番号, 列番号) の順番で、数値で指定します(1始まり)。
    • A列=1列目、B列=2列目、C列=3列目… とカウントします。
  • メリット:将来的に「1行ずつ順番に処理する」といった繰り返し処理(for文など)を組む際、変数を使って getRange(i, 1) のように動的にセルを指定できるため、自動化において必須の書き方となります!

パターン④:行番号・列番号・行数・列数(数値)で範囲を指定する

var range = sheet.getRange(2, 1, 4, 3); // 2行1列目から、縦に4行分・横に3列分
  • 説明: getRange(開始行, 開始列, 行数, 列数) の順番で指定します。
  • 解説:「2行目・1列目のセル(A2)を起点として、下に4行分・右に3列分伸ばした範囲(A2:C5)」という意味になります。

STEP3:【実践】「中央区エリア」のスープカレー店リストの範囲を取得してみよう

それでは、実際に手元のスプレッドシートを使ってコードを動かしてみましょう!

今回は、第3回で作成した「札幌スープカレー巡りリスト」のスプレッドシートを活用します。

1. スプレッドシートの準備

  1. 第3回で作成したスプレッドシートを開きます(なければ新規作成してください)。
  2. 「中央区エリア」シートに、以下のような表データを入力します。
A列(店名)B列(おすすめメニュー)C列(評価)
1行目店名おすすめメニュー評価
2行目マジックスパイスチキン涅槃★★★★★
3行目スープカレーGARAKUやわらかチキンレッグ★★★★☆
4行目奥芝商店宗谷牛ハンバーグ★★★★★
5行目Suage+パリッと知床鶏と野菜★★★★★
  1. 「中央区エリア」のシートタブをクリックして、画面上に表示(アクティブ化)させておきます。

2. GASのエディタ画面を開いてコードを入力する

  1. 画面上部メニューの 「拡張機能」 > 「Apps Script」 をクリックします。
  2. エディタ画面が開いたら、以下のコードをコピー&ペーストしてください。
function getMyRange() {
  // ①「家(ファイル全体)」を取得する
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  
  // ②「部屋(今開いているシート)」を取得する
  var sheet = ss.getActiveSheet();
  
  // ③【パターン①】A1表記で「A2セル」を取得する
  var rangeA1 = sheet.getRange("A2");
  
  // ④【パターン③】行列の数値指定で「2行目・1列目(=A2セル)」を取得する
  var rangeNum = sheet.getRange(2, 1);
  
  // ⑤【パターン④】数値指定で「2行1列目から縦4行・横3列の範囲(=A2:C5)」を取得する
  var rangeMulti = sheet.getRange(2, 1, 4, 3);
  
  // ⑥ それぞれ正しく範囲が掴めているか、範囲のアドレス(A1表記)をログに出力してみる
  Logger.log("rangeA1が指している範囲: " + rangeA1.getA1Notation());
  Logger.log("rangeNumが指している範囲: " + rangeNum.getA1Notation());
  Logger.log("rangeMultiが指している範囲: " + rangeMulti.getA1Notation());
}

3. 保存して実行する

  1. 画面上部の 「保存アイコン(フロッピーディスク)」 を押します。
  2. 実行する関数が getMyRange になっていることを確認し、「実行」 ボタンをクリックします。

4. 実行結果を確認する

画面下部の「実行ログ」に以下のように表示されれば大成功です!

情報    rangeA1が指している範囲: A2
情報    rangeNumが指している範囲: A2
情報    rangeMultiが指している範囲: A2:C5

※ getA1Notation() は、取得したRangeオブジェクトが「スプレッドシート上のどの範囲を指しているか」を文字列(例:”A2″ や “A2:C5″)で教えてくれる確認用の命令です。

指定の方法を変えても、狙った通りのマス目を正しく掴めていることが確認できましたね!

STEP4:超重要!初心者が100%ハマる「3つの落とし穴」

Sheet.getRange() を使う際、初心者が最初につまずきやすいポイントを3つまとめました。あらかじめ知っておくと無用なエラーで悩まされずに済みますよ!

落とし穴①:プログラミングの「0始まり」と混同してしまう

JavaScriptなどの一般的なプログラミング言語では、順番を数えるときに「0番目」からスタートすることが多いです。

しかし、スプレッドシートの行や列は 「1始まり」 です!

  • 1行目・1列目 = sheet.getRange(1, 1) (A1セル)
  • sheet.getRange(0, 0) と書いてしまうと「パラメータが一致しません」というエラーが発生します。

落とし穴②:getRange() をしただけでは「中の文字(値)」は取れない!

ここが一番の誤解ポイントです!

getRange() で取得できるのは、あくまで 「マス目の枠組み(Rangeオブジェクト)」 であり、中のデータそのものではありません。

例えるなら、「引き出しの取っ手に手をかけた状態」であって、まだ「引き出しを開けて中のメモ帳を取り出した」わけではないのです。

セルの中に入っている文字(例:「マジックスパイス」)を読み取ったり、書き換えたりするには、次回学ぶ .getValue() や .setValue() と組み合わせる必要があります。

落とし穴③:getRange(開始行, 開始列, 行数, 列数) の後半を「終わりの行・列」と勘違いする

数値で範囲を指定するパターン④(引数が4つの場合)、後半の数字を「〜行目まで」「〜列目まで」と覚えてしまう人が続出します。

  • ✕ 誤解: sheet.getRange(2, 1, 5, 3) ➡ 2行目から5行目まで指定できる?
  • ○ 正確: sheet.getRange(2, 1, 4, 3) ➡ 2行目から 「4行分」(2, 3, 4, 5行目)下へ伸ばす!

「何行目まで」ではなく 「何行分(高さ)」「何列分(幅)」 を指定するのだと覚えておきましょう。

まとめ:セルが掴めれば自動化まであと一歩!

今回は、スプレッドシートの目的のマス目を指定する Sheet.getRange() について解説しました。

  • getRange("A2") :特定の1セルをパッと直感的に指定したいとき
  • getRange(2, 1) :プログラムで繰り返し処理をしたいとき
  • getRange(2, 1, 4, 3) :表全体の広い範囲を一括指定したいとき

この「目的のマス目をプログラムで掴む」感覚が身につけば、GASでの自動化はもう目の前です!

次回(第5回)は、今回掴んだセルから 実際にデータを取り出す getValue() と、データを書き込む setValue() を使って、ついにスプレッドシートの値を読み書きしてみましょう!お楽しみに!