【コピペでOK！GAS基本操作】シートを取得する方法まとめ

こんにちは！
Yuki (@yukibnb) です。

Google Apps Script (GAS) でスプレッドシートのシートを取得する方法をまとめました。

スプレッドシートとシートの違い

スプレッドシート (Spreadsheet) とシート (Sheet) の違いは以下画像を参照ください。

スプレッドシートが親となるファイルで、その中に子となるシートがあります。

この記事ではシートを取得する方法を紹介します。

スプレッドシートを取得する方法は以下記事をご覧ください。
www.yukibnb.com

シートの取得方法まとめ

今開いているシートを取得する

今開いている = アクティブなシートを取得するコードです。

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sh = ss.getActiveSheet();

シート名を指定して取得する

シート名を指定することができます。
※後でシート名を変更すると取得できなくなるので注意してください。

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sh = ss.getSheetByName('シート名');

すべてのシートを取得する

スプレッドシート内の全てのシートを取得するコードです。

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sh = ss.getSheets();

シートをインデックス番号で指定して取得する

インデックス番号で指定することができます。

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sh = ss.getSheets()[/*数字*/];

もしくは

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sh = ss.getSheets();
var shid = sh[/*数字*/];

/*数字*/ の箇所を0以上の整数に置き換えてください。

ひとつめのシートを指定したい場合、1ではなく0を入力します。
ふたつめのシートを指定したい場合、2ではなく1を入力します。
みっつめの…… (以下同様)

まとめ

今回の記事ではスプレッドシートのシートを取得する方法を紹介しました。

紹介したようにシートを取得する方法は複数あるため、状況にあった方法をご使用ください。

　
シートの中のセル範囲や値を取得する方法は以下記事をご覧ください。
※「B2～C11セルの値を取得したい！」というような場合です。
www.yukibnb.com