前回(第3回)は、操作の土台となるスプレッドシートの中から、現在開かれているシートを特定する命令 Spreadsheet.getActiveSheet() について詳しく解説しました。
「家(スプレッドシートファイル)」に入り、「今いる部屋(シート)」を選ぶところまで進みましたね!
今回はその続きとして、GASでスプレッドシートを自動化する際の最重要テクニックである、目的のセルやセル範囲(マス目)をピンポイントで指定する命令 Sheet.getRange() をじっくり分かりやすく紐解いていきます!
STEP1:第3回の復習!「家・部屋・家具」の例えで理解する「Range」の位置づけ
コードを書き始める前に、まずは本連載でおなじみの「家・部屋・家具」の例えをおさらいしておきましょう。
GASでスプレッドシートのデータを操作するとき、プログラムは以下の階層構造で目的のデータを探しに行きます。
- 【家】= スプレッドシートファイル全体(Spreadsheet)
- 第2回で学んだ
SpreadsheetApp.getActiveSpreadsheet()で取得した対象です。
- 第2回で学んだ
- 【部屋】= 個別のシートタブ(Sheet)
- 第3回で学んだ
ss.getActiveSheet()で取得した「中央区エリア」などのシートです。
- 第3回で学んだ
- 【家具】= セル・セル範囲(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. スプレッドシートの準備
- 第3回で作成したスプレッドシートを開きます(なければ新規作成してください)。
- 「中央区エリア」シートに、以下のような表データを入力します。
| A列(店名) | B列(おすすめメニュー) | C列(評価) | |
| 1行目 | 店名 | おすすめメニュー | 評価 |
| 2行目 | マジックスパイス | チキン涅槃 | ★★★★★ |
| 3行目 | スープカレーGARAKU | やわらかチキンレッグ | ★★★★☆ |
| 4行目 | 奥芝商店 | 宗谷牛ハンバーグ | ★★★★★ |
| 5行目 | Suage+ | パリッと知床鶏と野菜 | ★★★★★ |
- 「中央区エリア」のシートタブをクリックして、画面上に表示(アクティブ化)させておきます。
2. GASのエディタ画面を開いてコードを入力する
- 画面上部メニューの 「拡張機能」 > 「Apps Script」 をクリックします。
- エディタ画面が開いたら、以下のコードをコピー&ペーストしてください。
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. 保存して実行する
- 画面上部の 「保存アイコン(フロッピーディスク)」 を押します。
- 実行する関数が
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() を使って、ついにスプレッドシートの値を読み書きしてみましょう!お楽しみに!
