シート操作したい(Sheet
)
1const book = SpreadsheetApp.getActiveSpreadsheet();
2const sheet = book.getActiveSheet();
Sheet
オブジェクトで単一のシートを操作できます。
シートの情報を確認したい
1const id = sheet.getId();
2const name = sheet.getName();
3const sheetName = sheet.getSheetName();
4
5const index = sheet.getIndex();
6const lastRow = sheet.getLastRow();
7const lastCol = sheet.getLastColumn();
行データを追加したい(appendRow
)
1// データのカラム数と同じ要素の配列を作成
2const data = ["A", "B", "C", "D"];
3// データをシート末尾に追記
4sheet.appendRow(data);
appendRow
で既存のシート末尾にデータを追加できます。
注釈
appendRow
の処理は時間がかかるので、大量のデータを追加する場合は、
配列で作成しsetValues
で書き出すほうがよいです。
データを削除したい(deleteRow
)
1// 2行目を削除
2sheet.deleteRow(2);
deleteRow
で行番号を指定してデータを削除できます。
データを削除したい(clearContent
)
1// 範囲を指定して削除
2const range = sheet.getRange("A2:D6");
3range.clearContent();
clearContent
で指定したセル範囲のデータを削除できます。
シート名を変更したい(setName
)
1sheet.setName("変更後のシート名");
setName
でシート名を変更できます。
同じ名前のシートは作れません。
シートを保護したい(protect
)
1// シート全体を保護
2const protection = sheet.protect()
3
4// セル範囲を保護
5const range = sheet.getRange("A2:D6");
6const protection = range.protect()
7
8// 保護の理由を追加
9protection.setDescription("説明")
protect
でシートや選択したセルを保護できます。
setDescription
で保護の理由を追加できます。