スプレッドシートの扱い

GASでスプレッドシートを操作する際のメソッドをまとめた。

スプレッドシートの作成

SpreadsheetApp.create("シート名");

• スプレッドシートの新規作成。drive直下に作成されるので、ディレクトリを変えたければ、driveメソッドで別途移動させるしかない。

スプレッドシートの指定

var ss = SpreadsheetApp.openById("シートID");　//シートのIDで指定
var ss = SpreadsheetApp.openByUrl(”スプレッドシートのURL”);　//URLで指定
var ss = SpreadsheetApp.open(file)　//driveAPPで取得したfileで指定

• 色々あるけど、シートIDで指定するのが一番使うかな。

スプレッドシートのシートの追加

var sheet = ss.insertSheet("シート名", index番号);

• 引数はどちらも省略可。

スプレッドシートのシートの指定

var sheet = ss.getSheetByName("シート名");　// シート名を指定
var sheet = ss.getActiveSheet();　// 最後にアクティブになっていたシートを指定

• シートを複数使用する場合は、シート名の指定は必須。

スプレッドシートの削除

ss.deleteSheet(sheet);

• スプレッドシートの削除メソッドに削除するシートを渡す。戻り値がvoid。

セルの範囲の指定

sheet.getRange(1, 1);

• 行、列の順に指定するとセルを指定できる。

sheet.getDataRange()

• 値が入っている範囲を全て取得する。行、列共に最大範囲を取得するため、表によっては空の値が多くなる。

データ取得

sheet.getRange(1, 1).getValues();
sheet.getDataRange().getValues();

• 範囲が複数の場合、値は配列で取得される。

データ書き込み

sheet.getRange(1, 1).setValue("値");

• 指定したセルに値を書き込む

データ削除

sheet.getRange(1, 1).clearContent();
sheet.getDataRange().clearContent();

• 指定した範囲の値を空にする。getDataRangeと組み合わせるとシート内の全ての値を削除できる。