指定した位置に空白行を挿入するの実装コード
Google Apps Script（GAS）において、スプレッドシートの指定した位置へ一括で空白行を挿入するには、SheetオブジェクトのinsertRowsメソッドを使用します。以下のコードを実行することで、アクティブなシートの指定位置に複数行の空白行を瞬時に追加できます。
const sheet = SpreadsheetApp.getActiveSheet();
sheet.insertRows(2, 3);仕様と技術的な注意点
insertRows(rowIndex, numRows)メソッドは、指定した行番号の位置に指定した行数の空白行をまとめて挿入するためのAPIです。引数と挙動の仕様は以下の通りです。
- insertRowsの挙動: 第1引数（
rowIndex）で指定した行番号の位置から、第2引数（numRows）で指定した数だけ空白行を挿入します。例えばinsertRows(2, 3)を実行すると、2行目の位置から3行分の空白行が挿入され、もともと2行目以降にあったデータは自動的に下方向（5行目以降）へ押し下げられます。 - 単一行の挿入: 1行だけ挿入したい場合は、
insertRowBefore(linePosition)やinsertRowAfter(linePosition)といった専用メソッドも利用可能です。
この機能は、集計表の途中に新規カテゴリのデータを割り込ませる際や、フォーマットを崩さずに動的なデータ入力領域を確保したい場合に非常に有効です。
落とし穴: 処理速度やパフォーマンスにおける最大の落とし穴は、大量の行を1行ずつループ内で挿入してしまうことです。GASからGoogleスプレッドシートへの操作はAPIコールを伴うため、繰り返し処理の中で何度もinsertRowを実行すると通信オーバーヘッドによりスクリプトの実行速度が極端に低下します。複数行を一度に挿入するメソッドを利用してAPIコールを減らし、処理速度を最適化してください。
実務での活用シーンとハマりポイント
実務においては、集計表の途中に新規カテゴリのデータを割り込ませる際に頻繁に使用されます。例えば、既存の小計行や見出し行の直前に新規データを挿入するための空欄を動的に作成し、後続の処理でデータを流し込むといった自動化フローを構築する際に不可欠です。
開発現場で発生しやすいハマりポイントとして、条件に合致する行を探しながらループ処理の中で行を挿入する際の「行番号のシフト」が挙げられます。上から順（1行目から）ループを回しながら行を挿入していくと、挿入された空白行の分だけ全体の行番号がズレてしまい、無限ループに陥るか意図しない位置に行が挿入され続ける原因になります。このようなループ内での行挿入を行う場合は、シートの末尾から上に向かって（逆順で）走査を行うか、一括で挿入に必要な行数を計算してinsertRowsで一度に処理を完了させる構成にすることで、エラーを回避し堅牢性を高めることができます。
この処理の基本メカニズム
この処理の基本メカニズムは、SpreadsheetAppクラスを起点としてアクティブなシートオブジェクトを取得し、そのシート構造に直接変更を加える操作に基づいています。getActiveSheet()で操作対象のシートを特定し、そのインスタンスのinsertRows()メソッドを呼び出すことで、スプレッドシートのバックエンドAPIに対して行挿入のリクエストが送信されます。
手動での行挿入作業によるヒューマンエラーを防ぎ、プログラム側で一括して領域を自動確保することで、データ処理の前処理を確実に実行できるメリットがあります。GASの実行時間制限（6分制限）を超過しないためにも、API通信回数を最小限に抑える実装（バルク処理）を行うことが、安定した業務自動化を実現するための重要なアプローチです。
※本記事は基本的なロジックおよび構文解説です。最新の仕様についてはGoogle Apps Script (GAS)の公式ドキュメントをご確認ください。
