前回(第6回)は、指定したセル(マス目)に直接データを書き込む Range.setValue() について学びましたね。「A2セルに『確定』と書く」「C4セルの金額を書き換える」といった、ピンポイントの更新操作ができるようになりました。
しかし、実際の業務や自動化ツールでよくあるのは、次のようなシチュエーションです。
- 「日々の出張費や交通費の申請を、シートの末尾に順番に追加していきたい」
- 「問い合わせフォームから届いたデータを、表の一番下にどんどん蓄積したい」
- 「毎日定時に実行されるログ(記録)を、既存の表を消さずに追記したい」
これを前回学んだ setValue() だけでやろうとすると、実は大きな壁にぶつかります。
「今、表の何行目までデータが入っているか?」をプログラムで毎回カウントし、空いている次の行(例えば「A5セル」)を計算して指定しなければならないからです。もし行数の計算を間違えると、せっかく蓄積してきた過去の大切なデータを上書きして消してしまう危険すらあります。
そこで今回登場するのが、表のデータ蓄積において圧倒的な威力を発揮する Sheet.appendRow() です!
この命令を使えば、GASが自動的に表の最終行を判別し、一番下に新しいデータを横一列(1行分)サッと追加してくれます。
今回は、この appendRow() の仕組みから、初心者がつまずきやすいポイント、実務で使える応用例まで、どこよりも詳しく・わかりやすく解説していきます!
1. そもそも Sheet.appendRow() とは?
appendRow() は、指定したシート(Sheetオブジェクト)の一番最後の行(データが入っている最終行の次の行)に、新しい1行分のデータを一括で追記する命令(メソッド)です。
英語の「append(アペンド)」には「(末尾に)追加する・付け加える」という意味があります。まさに「行を末尾に追加する」という名前通りの働きをしてくれます。
【イメージ】
[ A列 ] [ B列 ] [ C列 ]
1 日付 名前 内容
2 9/15 佐藤 札幌〜羽田 航空券
3 9/16 鈴木 都内移動費
----------------------------------------
4 9/20 高橋 JR(Uシート) ⬅【appendRowで自動追記!】
setValue() と appendRow() の違いを整理しよう
| 項目 | Range.setValue() | Sheet.appendRow() |
| 操作対象 | セル(Range) | シート(Sheet) |
| 書き込み位置 | 指定したピンポイントの1セル | 表の最終行の「次の行」 |
| 書き込み範囲 | 1つのセル(または指定範囲) | 横一列(1行分) |
| 既存データ | 上書きされるリスクあり | 過去のデータを保持したまま追記 |
| 主な用途 | ステータスの更新、計算結果の表示 | ログ記録、アンケート集計、経費申請の蓄積 |
2. 理解の鍵!「配列(はいれつ)」ってなに?
appendRow() を使いこなすために、どうしても避けて通れない重要概念が 「配列(Array)」 です。
初心者の方が一番戸惑う部分ですので、丁寧におさらいしておきましょう。
appendRow() の基本コードは次のように書きます。
sheet.appendRow([データ1, データ2, データ3]);
注目していただきたいのが、データを囲んでいる [ ](角カッコ) です。
この [ ] で囲まれたデータのまとまりのことを、プログラミングの世界で 「配列(はいれつ)」 と呼びます。
「お弁当箱の仕切り」でイメージしてみよう!
配列 [ ] は、仕切りのついた1つのお弁当箱 だと考えてみてください。
["2025/09/20", "高橋", 1590]という配列を作ると…- 仕切り1(0番目):
"2025/09/20"(日付) - 仕切り2(1番目):
"高橋"(名前) - 仕切り3(2番目):
1590(金額)
- 仕切り1(0番目):
この「仕切り付きお弁当箱」を appendRow() に渡すと、GASは仕切り順(左から順)にスプレッドシートの A列、B列、C列… へと自動的に並べてセルにセットしてくれます。
配列(お弁当箱) : [ "2025/09/20" , "高橋" , 1590 ]
↓ ↓ ↓
スプレッドシート : [ A列 ] , [ B列 ] , [ C列 ]
つまり、私たちが「何行目の何列目に書くか」を細かく指定しなくても、「1行分のセットデータ」を配列にして渡すだけで、GASが全部自動で処理してくれる仕組みになっているのです。
3. STEP1:準備!「札幌オフィスの出張経費メモ」を作成しよう
それでは、実際に手元のスプレッドシートを使って動作を確認していきましょう!
手順
- ブラウザで新しいGoogleスプレッドシートを作成し、ファイル名を 「札幌オフィス業務管理」 にします。
- 画面下のシートタブ名をダブルクリックし、「出張経費メモ」 に変更します。
- 1行目に、以下のような見出し(ヘッダー)とサンプルデータを入力してください。
| A | B | C | D | |
| 1 | 日付 | 申請者 | 内容 | 金額(円) |
| 2 | 2025/09/15 | 佐藤 | 札幌〜羽田 航空券 | 22000 |
| 3 | 2025/09/16 | 鈴木 | 都内移動費(ICカード) | 1500 |
- 入力が完了したら、「出張経費メモ」のシートを開いた状態(アクティブ)にしておきます。
4. STEP2:【実践】新しい経費データを一番下に自動追記してみよう!
準備ができたら、GASのエディタを開いてコードを書いていきましょう。
今回は、3行目の下に「高橋さんの移動費データ」を自動で追記する処理を作成します。
1. コードを入力する
スプレッドシートのメニューバーから 「拡張機能」 > 「Apps Script」 を開き、エディタ画面のコードをすべて消して以下を貼り付けます。
function addExpenseRecord() {
// ①「家(ファイル)」と「部屋(シート)」を取得する
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getActiveSheet();
// ② 追記したい1行分のデータを「配列 [ ]」で準備する
var newRowData = [new Date(), "高橋", "新千歳空港〜札幌 JR(Uシート)", 1590];
// ③ シートの一番下に自動追記する
sheet.appendRow(newRowData);
// ④ 実行ログで完了を確認する
Logger.log("新しい経費データを表の最終行に追加しました!");
}
2. コードを1行ずつ徹底分解解説!
初心者向けに、1行ごとに何が行われているのかを詳しく紐解きます。
var ss = SpreadsheetApp.getActiveSpreadsheet();- 第2回で学んだ命令ですね。今開いているスプレッドシート全体(家)を取得して変数
ssに入れています。
- 第2回で学んだ命令ですね。今開いているスプレッドシート全体(家)を取得して変数
var sheet = ss.getActiveSheet();- 第3回で学んだ命令です。選択されている「出張経費メモ」シート(部屋)を取得して変数
sheetに入れています。
- 第3回で学んだ命令です。選択されている「出張経費メモ」シート(部屋)を取得して変数
var newRowData = [ ... ];- ここで1行分のデータが入った「配列(お弁当箱)」を作成し、変数
newRowDataに代入しています。new Date():JavaScriptの機能で、実行した「現在の日時」を動的に生成します。"高橋":文字列データです(A列・B列・C列用は""で囲む)。"新千歳空港〜札幌 JR(Uシート)":内容となる文字列です。1590:金額データです。数値として計算に使えるよう、""で囲まずに数字のまま書きます。
- ここで1行分のデータが入った「配列(お弁当箱)」を作成し、変数
sheet.appendRow(newRowData);- 本日の主役です!
sheet(部屋)に対して.appendRow()を呼び出し、作成した配列newRowDataを渡しています。 - GASが内部で「現在は3行目までデータがあるな」と自動判定し、4行目のA〜D列へ一括入力してくれます。
- 本日の主役です!
3. 保存して実行する
- エディタ上部の 「保存アイコン(フロッピーディスクのマーク)」 をクリックします。
- 実行する関数が
addExpenseRecordになっていることを確認し、「実行」 ボタンをクリックします。 - スプレッドシートの画面に戻り、結果を確認してみましょう!
【実行結果の確認】
- 4行目に「今日の日付 / 高橋 / 新千歳空港〜札幌 JR(Uシート) / 1590」が綺麗に追加されました!
- もう一度GASに戻り、「実行」ボタンを再度押してみてください。今度は 5行目 に全く同じ内容が追記されます。
何行目までデータが入っているかを人間が計算しなくても、実行するたびに整然と下に蓄積されていくのが実感できたでしょうか?
5. STEP3:実務で差がつく!appendRow() の応用パターン3選
単にデータを固定で書くだけでなく、実務でよく使う3つの発展的な書き方を押さえておきましょう。
応用①:特定の列を「空欄(スキップ)」にして追記したい場合
「C列の内容は空白にして、A列・B列・D列だけにデータを入れたい」という場面もありますよね。
その場合は、配列の中に 空文字 "" または null を挟みます。
function addDataWithBlank() {
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// C列の位置に "" を挟むことで、C列を空白にして追記できる
var rowData = [new Date(), "佐々木", "", 3500];
sheet.appendRow(rowData);
}
配列の「順番(インデックス)」がそのままスプレッドシートの「列(A, B, C, D…)」に対応するため、空欄にしたい列の位置にも "" を置いて位置をずらさないようにするのが最大のコツです。
応用②:スプレッドシートの「計算式(数式)」を含めて追記する
appendRow() の配列には、"=SUM(C2:C10)" や "=D4*1.1" のような数式文字列を含めることもできます。
function addDataWithFormula() {
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// D列の値(税抜金額)をもとに、E列(5番目の要素)に消費税込みの計算式を入れる
// 例:=D4*1.1 のような数式を自動セット
var rowData = ["2025/09/20", "伊藤", "懇親会費(サッポロビール園)", 6000, "=D4*1.1"];
sheet.appendRow(rowData);
}
書き込まれた瞬間、スプレッドシート側で数式が評価され、セルには計算結果が表示されます。
応用③:プログラムの中で組み立てた変数を使って動的に追記する
実際の開発では、計算した結果や条件によって変わる文字を変数に入れて追記することがほとんどです。
function addDynamicLog() {
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// プログラムで動的に用意したデータ
var userName = "渡辺";
var item = "セコマのホットシェフ(ランチ代)";
var price = 620;
var status = "承認待ち";
// 変数を配列にまとめて追記!
sheet.appendRow([new Date(), userName, item, price, status]);
}
このように変数を並べるだけで、動的な自動ログシステムが簡単に構築できます。
6. 初心者が100%ハマる「4大トラブル」と完全対処法
appendRow() を使っていて「思い通りに動かない!」「エラーが出た!」というときにチェックすべき、初心者特有のハマりポイントを4つまとめました。
トラブル1:配列の [ ](角カッコ)をつけ忘れて崩れる
初心者事故率No.1のミスです。カッコの中にカンマ区切りで値をそのまま書いてしまうパターンです。
// ✕ エラーまたは予期せぬ動作(配列になっていない)
sheet.appendRow("2025/09/20", "高橋", "移動費", 1590);
// ◯ 正しい書き方(全体を [ ] で囲んで1つの配列にする)
sheet.appendRow(["2025/09/20", "高橋", "移動費", 1590]);
appendRow() は 「配列という1つの大きな箱」を1つだけ受け取るルール になっています。[ ] を忘れると、最初のデータ(”2025/09/20″)しか認識されなかったり、正しく追記されなくなります。
トラブル2:見た目は空欄なのに「はるか下の行(1000行目など)」に追記される
「実行ボタンを押したのに、表のすぐ下ではなく、なぜか100行目や1001行目といった遠い場所にデータが入ってしまう…」という謎の現象です。
【原因】
スプレッドシート上に、見た目では気づかない 「幽霊データ」 が残っていることが原因です。
たとえば、過去にスペースキーを押して「目に見えない空白」が入っていたり、数式で ""(空文字)を出力していたセル、フォーマット(枠線や背景色)だけが残っているセルがあると、GASは「ここはまだデータが入っている行だな」と判定します。
その結果、本当の意味でデータが一切ない「1001行目」まで飛んでいってしまうのです。
【解決策】
- スプレッドシート上で、データの入っていない空行を上から下までドラッグして選択します。
- 右クリックメニューから 「行を削除」 を実行し、完全な空行にします。
- その後、再度GASを実行してみてください。
トラブル3:range.appendRow() と書いて TypeError になる
// ✕ エラーになる書き方
var range = sheet.getRange("A2");
range.appendRow(["データ1", "データ2"]);
// エラーメッセージ:TypeError: range.appendRow is not a function
appendRow() は Sheet(部屋)が持っている専用の命令 です。Range(セル・家具)に対して使うことはできません。
「行を追加する」という操作はシート全体に関わることなので、必ず sheet.appendRow(...) のように シートオブジェクトに対して呼び出す ことを徹底しましょう。
トラブル4:日付を new Date() で入れると長〜い英語表記になる
new Date() を配列に入れて追記すると、スプレッドシート上では綺麗に日付表示されていても、GAS内部やログで見ると Sat Sep 20 2025 10:40:00 GMT+0900... と表示されて驚くことがあります。
もし最初から「2025/09/20」という形式でテキストとして確実に書き込みたい場合は、後日詳しく学ぶ Utilities.formatDate() や、以下のように文字列で日付を組み立てて渡すのも有効なテクニックです。
// 日付を「2025/09/20」のようなテキストとして整形して渡す例
var todayText = "2025/09/20";
sheet.appendRow([todayText, "高橋", "移動費", 1590]);
7. まとめ&次回予告
今回は、表の一番下にデータを自動追記する超便利命令 Sheet.appendRow() を徹底解説しました。
今日の重要ポイント
appendRow()はシートの最終行を自動判別し、次の行へ1行分のデータを追加する- 追記するデータは必ず
[データ1, データ2, ...]のように配列[ ]形式で渡す RangeではなくSheet(部屋)オブジェクトに対して命令を出す- 空欄の列を作りたいときは
""を配列内に挟んで列の位置を揃える
これで、「セルの読み取り(getValue)」「セルの更新(setValue)」「データの蓄積(appendRow)」という、GASによるスプレッドシート操作の3大基本がすべて揃いました!
さて、データを色々とテスト追記していると、「一旦練習で入れたデータや、特定の範囲の文字だけをきれいに消去してリセットしたい!」 という場面が出てきますよね。
次回(第8回)は、セルの文字やデータだけをサッと初期化する Range.clearContent() を解説します!
表の枠線や背景色のデザインは残したまま、中身の値だけを安全に消去するテクニックを学びましょう。お楽しみに!
