セルを操作したい(Range)
1// シートの全データを取得
2const range = sheet.getDataRange();
3
4// シートのセルを範囲選択して取得
5const range = sheet.getRange("A1:C3");
Rangeオブジェクトは、シート上の選択した範囲を操作できます。
Rangeの取得方法(getRange / getDataRange)についてはシートを操作したいを参照してください。
値を読み込みたい(getValues)
1const values = range.getValues();
Range.getValuesメソッドで、選択した範囲の値を2次元配列として取得できます。
見出し行を含むデータの扱い方はシートを操作したいを参照してください。
値を書き込みたい(setValues)
1const arrays = [
2 ["名前", "年齢"],
3 ["田中", 20],
4 ["鈴木", 30],
5];
6range.setValues(arrays);
Range.setValuesメソッドで、選択した範囲に2次元配列の値を書き込めます。
書き込みたい2次元配列のシェイプ(=行数と列数)と、選択範囲のサイズは揃っている必要があります。
セル範囲のデータを削除したい(clearContent)
1range.clearContent();
Range.clearContentで指定したセル範囲のデータを削除できます。
選択範囲を確認したい(activate)
1range.activate();
Range.activateメソッドで、実際に選択された範囲をシート上で確認できます。
デバッグ時など、選択範囲が正しいか確認するときに便利です。
スプレッドシートの関数を使いたい(setFormula)
1range.setFormula("=SUM(A1:C1)");
Range.setFormulaでSUMなどのスプレッドシートの関数を設定できます。
セルの書式を変更したい
1range.setFontSize(12);
2range.setFontFamily("Arial");
3range.setFontWeight("bold"); // "normal", "bold"
4range.setFontStyle("italic"); // "normal", "italic"
5range.setFontLine("underline"); // "none", "underline", "line-through"
6range.setFontColor("red");
7range.setBackground("yellow");
Range.setFontSizeなどで、選択したセルに対してフォントやスタイル、文字色などを設定できます。
セル範囲を保護したい(protect)
1const protection = range.protect();
2
3// 保護の理由を追加
4protection.setDescription("説明");
Range.protectで、選択したセル範囲だけを保護できます。
Protection.setDescriptionで保護の理由を追加できます。
シート全体を保護したい場合はシートを操作したいを参照してください。