範囲の値を取得する

スプレッドシートから、特定の範囲の値を取得する方法を解説します。

利用する関数

Spreadsheet.getSheetValues([開始行], [開始列], [行数], [列数]);

Spreadsheet クラスに用意されている、getSheetValues()を使用します。

引数は 4 つ必要で、それぞれ開始行、開始列、行数、列数を指定します。

例えば、対象シートのセル C2 から、4x5 の範囲が取得したい場合、getSheetValues(2, 3, 4, 5)と指定する必要があります。

返り値は文字列の配列の配列(string[][])として受け取ることができます。

実行にあたってスプレッドシートにアクセスすることになるため、初回実行時に認証が必要になる場合があります。

サンプルコード

/**
 * 対象スプレッドシートのID
 * https://docs.google.com/spreadsheets/d/〇〇〇/edit の〇〇〇の部分
 */
const SPREAD_SHEET_ID = '_______________';

/**
 * セルの高さを数値を指定して設定します
 */
const getSheetValues = () => {
  /** 対象スプレッドシート */
  const ss = SpreadsheetApp.openById(SPREAD_SHEET_ID);

  /** 対象シート */
  const sheet = ss.getSheetByName('シート1');

  /** 取得したデータ */
  const arrays = sheet.getSheetValues(2, 3, 4, 5);

  console.log(arrays);
  return arrays;
};

実行すると、指定したスプレッドシートについて、C2 から、4x5 の範囲が返却されます。