セルを操作したい(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で保護の理由を追加できます。 シート全体を保護したい場合はシートを操作したいを参照してください。

リファレンス