【GAS入門#19】不要なデータ行をまるごと消去!Sheet.deleteRow()の使い方と複数行削除の罠

幹事の皆さん、お疲れ様です!スプレッドシートで宴会やイベントの参加者リストを管理していると、「急にキャンセルが出たから名簿から消しておいて!」と頼まれること、日常茶飯事ですよね。

手作業で対象の行を右クリックして「行を削除」を選ぶのも、1〜2件なら簡単です。しかし、これが数十件に及んだり、毎日発生する作業だったりすると、大きな手間になります。さらに、マウスの操作ミスで別の大切な人のデータを消してしまうリスクも潜んでいます。

そこで第19回となる今回は、不要になった行をプログラムから自動でまるごと削除してくれる、GASの超便利メソッド Sheet.deleteRow() を解説します!

今回は定山渓温泉での宴会予約リストを題材に、「文字だけを消す命令」との決定的な違いや、初心者が必ずと言っていいほどつまずく「複数行を削除するときの恐ろしい罠(行ズレ問題)」まで、どこよりも詳細に、手取り足取り徹底解説していきます。 これさえ読めば、名簿のクレンジング(整理)が全自動でできるようになりますよ!

1. そもそも Sheet.deleteRow() とは?

Sheet.deleteRow()(シート・デリート・ロウ)は、スプレッドシートの 指定した行番号のデータを、行ごとまるごと削除する命令 です。

本連載おなじみ「家・部屋・家具」の例えで位置づけを復習!

GASでスプレッドシートを操作する際の階層構造を思い出してみましょう。

  • 【家】= スプレッドシートファイル全体(Spreadsheet)
  • 【部屋】= 個別のシートタブ(Sheet) ★今回の対象!
  • 【家具】= セルやセル範囲(Range)

deleteRow() は、「部屋(Sheet)」に対して呼び出す命令 です。「この部屋(シート)の、○行目の棚をまるごと撤去して!」と部屋全体に指示を出しているイメージになります。

「だるま落とし」でイメージしてみよう!

このメソッドの動きは、おもちゃの「だるま落とし」を想像すると非常にわかりやすいです。

だるま落としの中段にあるブロックをカーン!と弾き飛ばして抜き取ると、その上に乗っていたブロックがストンと下に落ちてきますよね。

deleteRow() も全く同じです。「3行目を削除して」と命令すると、3行目のデータが消滅し、もともと4行目や5行目にあったデータが、自動的にスライドして上に詰められます。

第8回で学んだ clearContent() との決定的な違い

「データを消す」と聞いて、第8回で学習した Range.clearContent() を思い出した方もいるかもしれません。この2つの違いを正確に理解しておくことが、バグを防ぐ第一歩です!

項目Range.clearContent()Sheet.deleteRow()
操作対象セル・範囲(Range)シート全体(Sheet)
消えるもの文字・数値・数式など「中身だけ」「行そのもの」(書式や色も含めて全消滅)
消した後の動きその場所に**「空白行」が残る**下のデータが**「上に詰められる」**
現実のイメージノートの文字を消しゴムで消すバインダーからルーズリーフを1枚引っこ抜く

不要な予約データや完了済みのタスクをリストから完全に除外して、表を隙間なくキュッと綺麗に保ちたいときは、今回の deleteRow() の出番というわけですね!

2. STEP1:準備!「温泉宴会予約リスト」を作成しよう

それでは、実際に手元のスプレッドシートで動かしながら学んでいきましょう。

スプレッドシートの準備手順

  1. ブラウザで新しいGoogleスプレッドシートを開き、ファイル名を 「宴会予約管理」 にします。
  2. 画面下のシート名を 「予約リスト」 に変更します。
  3. 以下の通りに、A列からD列までデータを入力してください。
ABCD
1氏名部署ステータス備考
2佐藤営業部予約済バス利用
3鈴木開発部キャンセル|
4高橋企画部予約済マイカー
5田中人事部キャンセル|
6伊藤総務部予約済バス利用

今回は、ステータスが「キャンセル」になってしまった鈴木さん(3行目)のデータを、GASを使って自動で行ごと削除してみます。

3. STEP2:【実践】指定した1行を自動で削除してみよう!

準備ができたら、GASのエディタを開いてコードを書いていきます。

1. コードを入力する

画面上部のメニューから 「拡張機能」 > 「Apps Script」 をクリックしてエディタを開き、最初から書かれているコードをすべて消去して、以下のコードを貼り付けてください。

function deleteCanceledRow() {
  // ① 「家(ファイル)」と「部屋(シート)」を取得する
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();
  
  // ② 削除したい行番号(鈴木さんがいる3行目)を変数に入れる
  var targetRow = 3;
  
  // ③ 指定した3行目をまるごと削除する!
  sheet.deleteRow(targetRow);
  
  // ④ 実行完了をログで確認
  Logger.log(targetRow + "行目のデータを削除し、下の行を上に詰めました!");
}

2. コードを1行ずつ超詳細に解説!

初心者の方が疑問に思いやすいポイントを分解して解説します。

  • var sheet = ss.getActiveSheet();
    • 第3回で学んだ、現在開いているシート(部屋)を取得する命令です。この「部屋」に対して削除の指示を出します。
  • var targetRow = 3;
    • 何行目を消すかを直接書いても良いのですが、このように一度変数に入れておくと、後から「今日は5行目を消そう」と思った時に修正箇所がわかりやすくなります。
  • sheet.deleteRow(targetRow);
    • 今回の主役です!シートに対して「3行目を消して!」と命令しています。この1行が実行された瞬間、スプレッドシート上でだるま落としが発生します。

3. 保存して実行する

  1. エディタ上部の 「保存(フロッピーアイコン)」 をクリックします。
  2. 実行する関数が deleteCanceledRow になっていることを確認し、「実行」 ボタンを押します。
  3. 初回実行時は権限の承認画面が出ることがあるので、画面の指示に従って許可してください。

4. 実行結果の確認

スプレッドシートの画面に戻ってみてください。

もともと3行目にいた「鈴木さん」の行が跡形もなく消え去り、下にあった「高橋さん」「田中さん」「伊藤さん」の行が、それぞれ 3行目、4行目、5行目にスライドして上に詰まっている はずです!

空白行が残らないので、リストがとても見やすくなりましたね。

4. 知っておくと便利!行・列を削除する関連メソッド一覧

GASには、1行だけを削除する deleteRow() の他にも、状況に合わせて使える便利な削除系メソッドが用意されています。

メソッド名働き主な使いどころ
Sheet.deleteRow(行)指定した「1行」を削除する特定の1件のデータを消したいとき
Sheet.deleteRows(開始行, 行数)指定した位置から**「複数の行」**を一気に削除する(例)2行目から下を全部リセットしたいときなどに sheet.deleteRows(2, 10) のように使う(※複数形の s が付きます)
Sheet.deleteColumn(列)指定した「1列」を削除する(例)不要になったC列をまるごと削除して、右の列を左に詰めたいとき

これらを組み合わせることで、不要な行も列もプログラムから自由自在にお掃除できるようになります。

5. 初心者が絶対ハマる!「4大トラップ」と完全解決策

deleteRow() は非常に強力ですが、使い方を少し間違えると、大切なデータを消してしまう大事故に繋がります。初心者の方が必ずと言っていいほど直面する「4つの罠」と、その完全な解決策をまとめました。

トラップ1:一番恐ろしい「複数行を上から削除してズレる罠」

「なるほど、行番号を指定して消せばいいんですね!じゃあ、キャンセルになった3行目(鈴木さん)と5行目(田中さん)を同時に消してみよう!」

……と思って、以下のようなコードを書くと、大事故が起きます。

❌ 絶対にやってはいけないNGコード

// 【危険】上から順番に消そうとするコード
sheet.deleteRow(3); // ① 3行目を消す
sheet.deleteRow(5); // ② 5行目を消す(つもりが別の行が消える!)

どうしてこれがNGなのでしょうか?

最初の deleteRow(3) を実行した瞬間、「だるま落とし」が発生して下の行が上に詰められますよね。

つまり、もともと5行目にいた「田中さん」が、上にズレて「4行目」に移動してしまうのです。

そのズレた状態で続けて deleteRow(5) を実行すると、田中さんではなく、さらに下にある「伊藤さん(もともと6行目だった人)」を誤って消去してしまいます!

⭕ 解決策:「一番下から上に向かって」削除する!

複数行をプログラムで削除したい場合は、「下から上に向かって(行番号の大きい順に)」削除していくのが、プログラミングの世界の絶対的な鉄則です。

下から消していけば、上の行は絶対にズレません。

// 【安全】下から順番に消すコード
sheet.deleteRow(5); // ① まず一番下の5行目を消す(上の行には影響なし!)
sheet.deleteRow(3); // ② 次に上の3行目を消す。これなら誰もズレない!

将来的に「for文(繰り返し処理)」を使って、キャンセルになった人を自動で探して何件もまとめて消すツールを作るときも、必ず「下の行から上に向かって逆ループで回す」という書き方をします。これは実務で必須のテクニックです!

トラップ2:Range(セル)に対して実行しようとしてエラーになる

❌ よくある間違い

var range = sheet.getRange("A3:D3");
range.deleteRow(); // エラー発生!

【原因と解決策】

deleteRow() は「部屋(Sheet)」が持っている命令であり、「家具(Range)」に対して使うことはできません。

TypeError: range.deleteRow is not a function というエラーが出た場合は、「シート全体に対して命令を出しているか?」を確認してください。必ず sheet.deleteRow(3) のように書きましょう。

トラップ3:配列のクセで「0始まり」で指定してしまう

第13回などで「プログラムの配列は0から数える」と学習した真面目な方ほど陥りやすいミスです。

「1行目を消したいから、sheet.deleteRow(0) かな?」と指定してしまうと、「行 0 が見つかりません」というエラーになります。

スプレッドシートの行番号を直接操作する系のメソッド(insertRowBeforeやdeleteRowなど)は、見た目通りの 「1始まり」 です。1行目を消したいなら素直に 1 を指定しましょう。

トラップ4:存在しない行(範囲外)を消そうとしてエラーになる

現在のシートが「100行」までしか存在しないのに、sheet.deleteRow(101) のように存在しない行を削除しようとするとエラーで処理が止まってしまいます。

プログラムで自動的に行番号を計算して削除を行う場合は、第11回で学んだ sheet.getLastRow()(最終行の取得)などを組み合わせて、「本当にその行が存在するか」を確認してから削除するようにすると完璧です。

6. まとめ&次回予告

今回は、不要な行を綺麗に消し去る Sheet.deleteRow() を超・詳細に解説しました。

今日の重要ポイントおさらい

  1. deleteRow() は行をまるごと削除し、下のデータを上に詰める(だるま落とし)
  2. clearContent() のような空白行が残らないので、リスト整理に最適
  3. シート(Sheetオブジェクト)に対して呼び出す命令である
  4. 【超重要】複数行を消すときは、行がズレるのを防ぐため「下から上へ(行番号の大きい順に)」消すのが絶対の鉄則!

キャンセル処理や古いタスクの一掃など、表を常に最新で隙間なく綺麗な状態に保つために欠かせない機能です。行ズレの罠に気をつけて、ぜひ実務に取り入れてみてくださいね!

次回(第20回)は、フェーズ1・2の集大成として、バラバラに並んだデータを綺麗に整列させる Range.sort() を解説します!

「北海道の山・標高ランキング」を題材に、高い順(降順)や低い順(昇順)に一発で並び替えるテクニックをわかりやすくご紹介しますので、どうぞお楽しみに!