【初心者向けのGAS】スプレッドシートに行を追加(挿入)する方法

よこのじ(@yokonoji_work)です。

Google Apps Script(GAS)で「スプレッドシートに行を追加(挿入)する方法」をご紹介します。

列を追加(挿入)する方法については「【初心者向けのGAS】スプレッドシートに列を追加(挿入)する方法」を参照ください。

スプレッドシートに行を追加(挿入)する方法

スプレッドシートに行を追加(挿入)するためには、対象のシートを指定しておく必要があります。

// スプレッドシートを取得する 
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); 
// シートを取得する
var sheet = spreadsheet.getSheetByName("シート1");

指定した行の後ろ(After)に行を追加(挿入)する方法

指定した行の後ろ(After)に行を追加(挿入)するには、insertRowAfterメソッドを使用します。

sheet.insertRowAfter(2)

この例では、対象シートの2行目の後ろ(After)に行を追加しています。

2行の後ろに行を追加

よって、「b」が記入されている行の後ろに空白の行が追加されました。

また、insertRowsAfterメソッドを使用することで、複数の行を追加(挿入)することも出来ます。

sheet.insertRowsAfter(2, 3);

この例では、対象シートの2行目の後ろ(After)に3つの行が追加されます。

指定した行の前(Before)に行を追加(挿入)する方法

指定した行の前(Before)に行を追加(挿入)するには、insertRowBeforeメソッドを使用します。

sheet.insertRowBefore(2)

この例では、対象シートの2行目の前(Before)に行を追加しています。

2行の前に行を追加

よって、元々「b」が記入されていた2行目の前に行が追加されました。

また、insertRowsBeforeメソッドを使用することで、複数の行を追加(挿入)することも出来ます。

sheet.insertRowsBefore(2, 3);

この例では、対象シートの2行目の前(Before)に3つの行が追加されます。

 

【初心者向けのGAS】スプレッドシートの行を削除する方法」で行を削除する方法もご確認ください。

Google Apps Scriptにはリファレンスがあるけど、なんだか使いづらいので本を持っておきたい。