【GAS入門#18】表の一番上にデータを割り込み挿入!Sheet.insertRowBefore() を超わかりやすく解説

日々の業務でスプレッドシートにデータを蓄積していると、「どんどん下に追加していくのではなく、最新のデータを表の『一番上』に目立たせて追加したい!」と思う瞬間はありませんか?

例えば、社内への最新ニュース、今日発生した重要タスク、最新の売上報告など、「パッと開いたときに一番最初に目に入ってほしい情報」は、スクロールしないと見えない表の一番下(最終行)にあると不便ですよね。

前回(第17回)までは、データの加工や文字列の操作を学んできましたが、今回は表の構造そのものをプログラムから操作するステップに入ります! 指定した行の「上」に新しい空の行をサッと割り込み挿入できる超便利メソッド、Sheet.insertRowBefore() をどこよりも詳しく、超・初心者向けに徹底解説します。

今回は、「最新のニュース」をリストの最上部(見出しのすぐ下)に自動で割り込み挿入する実践コードを通して、その使い方を完璧にマスターしていきましょう!

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

Sheet.insertRowBefore()(インサート・ロウ・ビフォア)は、スプレッドシートの指定した行番号のすぐ「上」に、新しい空の行を1行だけ挿入する命令です。

「本棚に新しい本を割り込ませる」イメージで理解しよう!

本棚に本が順番に並んでいるとします。 「2番目の位置に、新しい本を入れたい!」と思ったとき、あなたはどうしますか? まずは2番目以降の本を全部少しずつ右にズラして、「空きスペース」を作りますよね。

insertRowBefore() はまさにそれと同じことをしてくれます。

「2行目の上に新しい行を入れる」と命令すると、GASが自動的に既存の2行目以降のデータをすべて1行ずつ下へズラし、綺麗な「空きスペース(新しい2行目)」を作ってくれるのです。

基本的な書き方(構文)

// 指定した行(例:2行目)の「上」に空行を挿入する
sheet.insertRowBefore(2);

「Before(前・上)」という名前の通り、指定した位置の前にスペースをこじ開ける命令だと覚えてください。

第7回で学んだ Sheet.appendRow() は「表の一番最後(下)にデータを追加する」命令でしたが、この insertRowBefore() を使えば、表の好きな場所にデータを割り込ませることができるようになります。

2. STEP1:準備!「社内ニュース一覧」を作成しよう

それでは、実際に手元のスプレッドシートを使って動作を確認してみましょう。今回は札幌オフィスでの情報共有を想定した、シンプルなニュース一覧表を作ります。

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

  1. ブラウザで新しいGoogleスプレッドシートを開きます。
  2. ファイル名を 「社内ニュース管理」 にします。
  3. シート名を 「ニュース一覧」 に変更します。
  4. 以下のように、1行目に見出し、2行目と3行目に既存のニュースデータを入力しておきます。
AB
1日付ニュース内容
22026/11/10冬タイヤへの交換を推奨します。
32026/11/05オフィスの暖房設備点検が完了しました。

この状態から、プログラムを使って「最新の積雪ニュース」を見出しのすぐ下(新しい2行目)に割り込ませて追加する処理を作っていきましょう!

3. STEP2:【実践】最上部に新しい行を挿入してデータを書き込もう!

GASのエディタを開いて、実際にコードを書いていきます。

1. コードを入力する

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

function insertLatestNews() {
  // ① 「家(ファイル)」と「部屋(シート)」を取得する
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();

  // ② 2行目の「上」に新しい空行を1行挿入する!
  // (既存の2行目以降のデータは自動的に1行ずつ下に押し出されます)
  sheet.insertRowBefore(2);

  // ③ 新しくできた空の2行目に書き込むための「2次元配列」データを準備する
  var newNews = [
    ["2026/11/12", "【速報】今夜から明朝にかけて積雪の予報が出ています。"]
  ];

  // ④ 第14回で学んだ setValues() を使って、2行目に一括書き込み!
  // getRange(開始行:2, 開始列:1, 行数:1, 列数:2) = A2:B2 の範囲を指定
  sheet.getRange(2, 1, 1, 2).setValues(newNews);

  // ⑤ 実行完了をログで確認
  Logger.log("最新ニュースを最上部に挿入し、書き込みが完了しました!");
}

2. コードを1行ずつ徹底解説!

初心者の方がつまずかないよう、何が起きているのか分解して解説します。

  • sheet.insertRowBefore(2);ここが今回のメインイベントです!「2行目の上に空の行を作って!」と命令しています。これにより、元の2行目(冬タイヤのニュース)は3行目へ、3行目(暖房のニュース)は4行目へと自動的に押し出されます。
  • var newNews = [ ["日付", "内容"] ]; 第14回で学んだ2次元配列の復習です。setValues() を使って複数のセル(今回はA2とB2)に一気にデータを流し込むため、全体を大きな [ ] で囲み、その中に1行分のデータ [ ] を入れています。
  • sheet.getRange(2, 1, 1, 2).setValues(newNews); 新しく作られた空っぽの2行目に対して、準備したデータを流し込んでいます。getRange(2, 1, 1, 2) は「2行目、1列目(A列)からスタートして、縦に1行分、横に2列分の範囲」という意味になります。

3. 保存して実行する

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

4. 実行結果の確認

スプレッドシートの画面に戻ってみてください! 既存のデータが下に綺麗にズレて、2行目に「【速報】今夜から明朝にかけて積雪の予報が出ています。」という最新ニュースが割り込んで追加されているはずです!

4. 知っておくと便利!行を操作する関連メソッド一覧

GASには、行を追加・挿入するための命令がいくつか用意されています。実務での目的に合わせて使い分けられるようにしておきましょう。

メソッド名働き主な使いどころ
Sheet.appendRow()表の**一番最後(下)**に1行追加し、同時にデータを書き込む。日々の売上ログや、問い合わせフォームの蓄積など、時系列で下へ伸ばしていくデータに最適。
Sheet.insertRowBefore(行)指定した行の上に1行挿入する(空行を作る)。【今回学習】最新情報を一番上に目立たせたい時や、特定項目の前に割り込ませたい時に便利。
Sheet.insertRowAfter(行)指定した行の下に1行挿入する(空行を作る)。選択した行の直下に補足データを入れたい場合など。
Sheet.insertRowsBefore(行, 行数)指定した行の上に、**複数の行(2行以上)**をまとめて挿入する。一気に5行分のスペースをこじ開けたい時などに使用。(複数形の s がつきます)

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

insertRowBefore() を使う際、初心者の方が「あれ?おかしいな?」とパニックになりやすい落とし穴を3つ厳選しました。あらかじめ知っておけば怖くありません!

トラップ1:「挿入したのにデータが入らない!」

appendRow() は「行の追加」と「データの書き込み」を同時にやってくれる親切な命令でした。 しかし、今回学んだ insertRowBefore() は、あくまで「空っぽの行を新しく作る(スペースをこじ開ける)」だけの命令です。 これ単体ではデータは入らないため、挿入した後は、必ず getRange() と setValues()(または setValue())を使って、新しくできた行にデータを書き込む処理をセットで行う必要があります。

トラップ2:行番号は「0始まり」ではなく「1始まり」!

第13回や第15回で「配列の番号(インデックス)は0から数える」と解説しましたよね。 そのため、「一番上に挿入したいから、0を指定すればいいのかな?」と insertRowBefore(0) と書いてしまう方が非常に多いです。 しかし、スプレッドシートの行番号を直接指定する命令においては、見た目通りの「1始まり」が正解です! 1行目の見出しの下(=2行目の上)に入れたいなら、素直に 2 と指定してください。0 を指定するとエラーになってプログラムが止まってしまいます。

トラップ3:書式(背景色や太字)が上の行から引き継がれてしまう

スプレッドシートの仕様上、新しく行を挿入すると、挿入した場所の「すぐ上」の行の書式設定(色や太字など)を自動的にコピーしてしまうというおせっかいな機能があります。 今回の場合、見出しである1行目の下に挿入したため、もし1行目を「背景色グレー・太字」にしていたら、新しく入った2行目のニュースもグレーで太字になってしまいます。 これを防ぐためには、書き込んだ後に第8回〜第10回で学んだ装飾リセットの命令を挟むと完璧です。

// 書き込んだ後、書式を通常に戻す(太字解除・背景色なし)
sheet.getRange(2, 1, 1, 2).setFontWeight("normal").setBackground(null);

6. まとめ&次回予告

今回は、表の好きな場所に新しい行を割り込ませる Sheet.insertRowBefore() を徹底解説しました。

  • 指定した行の「上」に空行をサッと作ってくれる命令
  • 最新のデータを表の一番上に目立たせたいときに大活躍
  • 挿入しただけではデータは入らないので、setValues() とセットで使う
  • 行番号の指定は「1始まり」なので 0 は使わない

最新のデータが常に一番上に来るようにしておけば、チームのメンバーがいちいち下までスクロールする手間が省け、業務効率がグッと上がりますよ!

さて、行を自由に追加・挿入できるようになったら、次は「不要になった行をプログラムで綺麗にお掃除(削除)したい」ですよね。 次回(第19回)は、キャンセルになった予定などの不要な行をピンポイントで消し去る Sheet.deleteRow() を解説します!表を常に綺麗に保つための必須スキルですので、お楽しみに!