メインコンテンツまでスキップ

範囲の値を取得する

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

利用する関数

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 の範囲が返却されます。