GAS PR

[GAS]シートの行・列を追加・挿入・削除する方法 -Sheetクラス-

記事内に商品プロモーションを含む場合があります

Google Apps Script (GAS) でシートの行・列を追加・挿入する方法、また削除する方法を説明します。

Sheetクラスのメソッドを利用した手順について説明します。

SpreadSheetクラスでアクティブなシートに対して実施する方法については、下記をご覧ください。

Google Apps Scriptの基本的な使い方については下記をご覧ください。

Contents
  1. GASによるスプレッドシート操作の概要
  2. このシートに行を挿入する
  3. このシートに列を挿入する
  4. このシートの行を削除する
  5. このシートの列を削除する
  6. まとめ

GASによるスプレッドシート操作の概要

GASでスプレッドシートを操作するための「SpreadSheetサービス」は、主に下記のクラスで構成されています。

クラス説明
SpreadSheetAppSpreadSheetサービスの親クラス
Spreadsheetスプレッドシートを操作するクラス
Sheetシートを操作するクラス
Rangeセル範囲を操作するクラス

それぞれ下記のような位置付けになります。

「SpreadSheetApp」→「SpreadSheet」→「Sheet」→「Range」という順の階層構造になっています。操作対象に応じて、下の階層にたどってオブジェクトを取得して利用します。

このページでは、上記の中のSheetクラスの下記のメソッドについて説明します。

メソッド戻り値説明
insertRowBefore(beforePosition)Sheetこのシートの指定した行の前に行を挿入する
insertRowsBefore(beforePosition, howMany)Sheetこのシートの指定した行の前に複数の行を挿入する
insertRowAfter(afterPosition)Sheetこのシートの指定した行の後に行を挿入する
insertRowsAfter(afterPosition, howMany)Sheetこのシートの指定した行の後に複数の行を挿入する
insertRows(rowIndex)voidこのシートの指定した行の前に行を挿入する
insertRows(rowIndex, numRows)voidこのシートの指定した行の前に複数の行を挿入する
insertColumnBefore(beforePosition)Sheetこのシートの指定した列の前に列を挿入する
insertColumnsBefore(beforePosition, howMany)Sheetこのシートの指定した列の前に複数の列を挿入する
insertColumnAfter(afterPosition)Sheetこのシートの指定した列の後に列を挿入する
insertColumnsAfter(afterPosition, howMany)Sheetこのシートの指定した列の後に複数の列を挿入する
insertColumns(columnIndex)voidこのシートの指定した列の前に列を挿入する
insertColumns(columnIndex, numColumns)voidこのシートの指定した列の前に複数の列を挿入する
deleteRow(rowPosition)Sheetこのシートの指定した行を削除する
deleteRows(rowPosition, howMany)voidこのシートの指定した複数の行を削除する
deleteColumn(columnPosition)Sheetこのシートの指定した列を削除する
deleteColumns(columnPosition, howMany)voidこのシートの指定した複数の列を削除する

このシートに行を挿入する

このシートの指定した場所に行を挿入するメソッドを説明します。

このシートの指定した行の前に行を挿入する:insertRowBefore(beforePosition)

このシートの指定した行の前に行を挿入する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。もともとの3行目の上に新しい行が挿入されます。

このシートの指定した行の前に複数の行を挿入する:insertRowsBefore(beforePosition, howMany)

このシートの指定した行の前に複数の行を挿入する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。もともとの3行目の上に新しい行が3行挿入されます。

このシートの指定した行の後に行を挿入する:insertRowAfter(afterPosition)

このシートの指定した行の後に行を挿入する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。3行目の下に新しい行が挿入されます。

このシートの指定した行の後に複数の行を挿入する:insertRowsAfter(afterPosition, howMany)

このシートの指定した行の後に複数の行を挿入する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。3行目の下に新しい行が3行挿入されます。

このシートの指定した行の前に行を挿入する:insertRows(rowIndex)

このシートの指定した行の前に複数の行を挿入する方法です。

insertRowBefore(beforePosition)と同様の動作になります。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。もともとの3行目の上に新しい行が挿入されます。

このシートの指定した行の前に複数の行を挿入する:insertRows(rowIndex, numRows)

このシートの指定した行の前に複数の行を挿入する方法です。

insertRowsBefore(beforePosition, howMany)も同様の動作になります。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。もともとの3行目の上に新しい行が3行挿入されます。

このシートに列を挿入する

このシートの指定した場所に列を挿入するメソッドを説明します。

このシートの指定した列の前に列を挿入する:insertColumnBefore(beforePosition)

このシートの指定した列の前に列を挿入する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。もともとの3列目の左に新しい列が挿入されます。

このシートの指定した列の前に複数の列を挿入する:insertColumnsBefore(beforePosition, howMany)

このシートの指定した列の前に複数の列を挿入する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。もともとの3列目の左に新しい列が3列挿入されます。

このシートの指定した列の後に列を挿入する:insertColumnAfter(afterPosition)

このシートの指定した列の後に列を挿入する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。3列目の右に新しい列が挿入されます。

このシートの指定した列の後に複数の列を挿入する:insertColumnsAfter(afterPosition, howMany)

このシートの指定した列の後に複数の列を挿入する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。3列目の右に新しい列が3列挿入されます。

このシートの指定した列の前に列を挿入する:insertColumns(columnIndex)

このシートの指定した列の前に列を挿入する方法です。

insertColumnBefore(beforePosition)と同様の動作です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。もともとの3列目の左に新しい列が挿入されます。

このシートの指定した列の前に複数の列を挿入する:insertColumns(columnIndex, numColumns)

このシートの指定した列の前に複数の列を挿入する方法です。

insertColumnsBefore(beforePosition, howMany)と同様の動作です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。もともとの3列目の左に新しい列が3列挿入されます。

このシートの行を削除する

このシートの指定した行を削除するメソッドを説明します。

このシートの指定した行を削除する:deleteRow(rowPosition)

このシートの指定した行を削除する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。指定した3行目が削除されます。

このシートの指定した複数の行を削除する:deleteRows(rowPosition, howMany)

このシートの指定した複数の行を削除する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。指定した3行目から2行分が削除されます。

このシートの列を削除する

このシートの指定した列を削除するメソッドを説明します。

このシートの指定した列を削除する:deleteColumn(columnPosition)

このシートの指定した列を削除する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。指定した3列目が削除されます。

このシートの指定した複数の列を削除する:deleteColumns(columnPosition, howMany)

このシートの指定した複数の列を削除する方法です。

下記のように実行します。

下記のファイルに対して実行すると、

下記の結果になります。指定した3列目から2列分が削除されます。

まとめ

Google Apps Script (GAS) でシートの行・列を追加・挿入する方法、また削除する方法を説明しました。

GASは無料で利用できてとても便利なツールです。

Googleスプレッドシート等のGoogleアプリケーションを利用されている方は、GASを習得することで作業を大きく効率化できます

GASの基本構文を知りたい方は、下記もご覧ください。