指定した行を削除するの実装コード
Google Apps Script（GAS）においてスプレッドシートの指定した行を削除するには、Sheetクラスが提供するdeleteRow()メソッドを使用するのが最もシンプルで効果的です。以下のコードを実行すると、アクティブなシートの2行目が削除され、それ以降の行が上方向に詰められます。
const sheet = SpreadsheetApp.getActiveSheet();
sheet.deleteRow(2);仕様と技術的な注意点
deleteRow(rowPosition)メソッドは、第一引数に削除したい行番号（1から始まる行のインデックス）を指定します。このメソッドが実行されると、指定された行が完全に削除され、その行より下に存在するすべてのデータ行が自動的に1行分上に詰まるという挙動を示します。
単一の行ではなく、連続した複数の行をまとめて削除したい場合は、deleteRows(rowPosition, howMany)メソッドを活用するのが効率的です。第一引数に開始行番号、第二引数に削除する行数を渡すことで、APIの呼び出し回数を減らし、スクリプトの実行パフォーマンスを大幅に向上させることができます。
プログラムによる行削除処理で最も注意すべき落とし穴が、条件分岐を用いたループ処理時の「行番号のずれ」です。行を上から順（1行目→2行目…）に判定して削除していくと、削除が発生するたびに以降の行番号が1つずつ上に繰り上がります。その結果、本来チェックすべき行がスキップされたり、意図しない行が削除されたりするバグが発生します。そのため、ループ処理で行を削除する場合は、必ず「行番号の大きい順（末尾から先頭へ）」に向かって逆順で処理を行うのが開発における絶対的な原則です。
実務での活用シーンとハマりポイント
実務の現場において、行削除機能は不要になった古いログデータの整理や、ステータスが「対応完了」になったタスクのクレンジング、定期的な不要データの自動メンテナンス作業などで頻繁に活用されます。例えば、毎月末に過去30日以上前の実行ログを自動で削除し、スプレッドシートのファイルサイズ肥大化を防ぐといった自動化運用が代表的です。
開発初心者が特にハマりやすいポイントは、順方向ループによる削除漏れと、大量行削除時の実行速度低下です。例えば、数千行あるデータの中から特定条件の行を1行ずつdeleteRow()で消していくと、GASの実行時間制限（標準アカウントで6分）を超えてタイムアウトエラーが発生することがあります。これを回避するためには、逆順ループで処理することはもちろん、連続する行を計算してdeleteRows()でまとめて消去するか、データを一度配列として全件取得し、JavaScriptのfilter()メソッド等で不要な行を取り除いたうえでシート全体を上書き書き込みする手法を検討するのが実用的です。
この処理の基本メカニズム
GASにおける行削除のメカニズムは、スプレッドシートのUI上で人間が行う「行の削除」操作をプログラム経由で再現したものです。まずSpreadsheetApp.getActiveSheet()によって現在操作対象となっているシートオブジェクトの参照を取得し、そのオブジェクトに対してdeleteRow()またはdeleteRows()命令を発行します。
スプレッドシートの行番号は「1オリジン（最初の行が1）」であるのに対し、JavaScriptの配列インデックスは「0オリジン（最初の要素が0）」である点も概念上の重要な整理ポイントです。API内部では、指定された行のセルデータおよび書式情報を削除したうえで、それ以降のすべての行データを上方向へ一括シフトするインデックスの再配置が自動的に行われます。この構造を理解しておくことで、データ肥大化によるスプレッドシートの動作遅延や、手動メンテナンスによる人為的削除ミスといった業務課題を論理的かつ確実に解決できるようになります。
※本記事は基本的なロジックおよび構文解説です。最新の仕様についてはGoogle Apps Script (GAS)の公式ドキュメントをご確認ください。
