はじめに

この記事は「Ateam LifeDesign Advent Calendar 2023」で完走賞を狙って25記事書いているうちの2日目の記事です。今年も完走目指して頑張るぞ！

セルの操作

GASでなにかものを作るときによく使うセルの操作。今日はここにフォーカスをあててまとめていきます。
ステップは以下の通り。

1. スプレッドシート本体のオブジェクトを取得
2. 対象となるシートオブジェクトを取得
3. セルオブジェクトを取得
4. 該当のセルのオブジェクトを取得したり変更する

コードにするとこんな感じ。

function myFunction() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
  var range = sheet.getRange("A1");
  var value = range.getValue();
  Logger.log(value);
}

このシートに対して実行すると

無事にリンゴが出力されました。

今回はアクティブな（開いている）シートを対象として値を取得していますが、シート名をしていしたりファイル名を指定して別ファイルからデータを持ってくることも可能です。

getRange

getRangeの引数の指定の仕方には4種類あるのでそれぞれ使い方を見ていきましょう。

Sheetオブジェクト.getRange(“R1C1形式")

先程のサンプルで記載したようにgetRange("A1")のように指定する方法です。複数範囲の指定も可能で、getRange(“A3:F6")とするとA3からF6までのセルを取得することが出来ます。
ただこの指定の仕方は人が見るとわかりやすいものの、文字列（アルファベット順）で指定するため連続してとってくる指示などをプログラム中での指定がし辛く、使う頻度は少ないかも知れません。明示的に「この1つのセルをとってくる」という場合以外は使い道がないかも。

Sheetオブジェクト.getRange(行番号, 列番号)

これは1つのセルを指定して値を取ってきたり値を入力するときに使う方法で、取得したいセルの行番号と列番号を引数に指定します。例えばB1セルを取得する場合はgetRange(1, 2)のように指定します。
上述の通り1つのセルを指定することになるのでその後はgetValueで値を取り出します。

function myFunction() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
  var range = sheet.getRange(1, 2);
  var value = range.getValue();
  Logger.log(value); // B1セルの値が出力される
}

Sheetオブジェクト.getRange(行番号, 列番号, 行数)

先程のパターンに3つ目の引数として行数が追加されたかたちです。主にスプレッドシートでは行方向に情報を追加していくのでデータを1列を縦方向に取得する際に利用します。
getRange(3,2,5)とすると、B3:B7の合計5つのセル範囲がRnageオブジェクトとして取得されます。
今回の場合は複数のセルを取得しているためgetValueではなくgetValuesで値を取得します。ここで得られる配列は1次元ではなく2次元配列となるため扱う際は気をつけてください。

function myFunction() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
  var range = sheet.getRange(3,2,5);
  var value = range.getValues();
  Logger.log(value);
}

このシートに対して上記のスクリプトを実行すると

こんな実行結果が得られます。2次元配列になってますね。

でもこうやってとってきた値ってだいたい1次元配列で使いたいことのほうが多くないですか？そんなことない？？？
そんなときはこうしてやることで1次元配列に変換してやることができます。

var value = range.getValues().flat().filter(Number).map(Number);

1次元になった。

Sheetオブジェクト.getRange(行番号, 列番号, 行数, 列数)

先程のものに4つ目の引数として列を追加しています。複数列を複数行に渡って取得します。実際にGASのコードを書いてて一番使うのがこのパターンです。
getRange(3,2,5,2)と引数を指定すると、B3:D7のセル範囲をRangeオブジェクトとして取得されます。

function myFunction() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
  var range = sheet.getRange(3,2,5,3);
  var value = range.getValues();
  Logger.log(value);
}

これを先程と同じシートに対して実行してみると

こんな結果が得られます。こちらも二次元配列で取得されます。

setValue と setValues

上記ではgetRangeでセル（の範囲）を指定してをそこの値を取ってきましたが、同様にgetRangeしたものに対してsetValueしてやることで値を書き込むことが出来ます。単一のセル取得をした場合はsetValueを、複数のセル取得をした場合はsetValuesを使います。

function myFunction() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
  var singleRange = sheet.getRange(1,1);
  singleRange.setValue("a");
  var multiRange = sheet.getRange(3,2,3,2);
  multiRange.setValues([["b", "c"], ["d", "e"], ["f", "g"]]);
}

実行結果はこちら。

最後に

今日はGASの中でも利用頻度が高いセルの操作についてまとめました。
まだこれだけだとなかなか便利なものが出来るイメージが湧かないと思うので明日からは実際にものを作りながらその中で使った関数について説明していきます。