今更ながら GASよく使うメソッド集

概要

　この記事は、Google App Script（GAS） についての備忘録です。

特有のルール・知識

• コンテナバインドスクリプト : Googleアプリケーションと結びついたGAS
• スタンドアロンスクリプト : 単体で動くGAS
• Googleアプリケーションに対する操作では承認が必要
• Spreadsheetは、 Spreadsheetオブジェクト > Sheetオブジェクト > Rangeオブジェクト という包含関係がある
• 無限ループは６分で停止する
• scriptは同一プロジェクト内で複数ファイルに分割でき、あるファイルで記述した変数はimport, exportせずに使用できる

ショートカット

実行

Command or Control + R

ログ閲覧

Command or Control + Enter

Javascript と似ている文法

for文

for(初期化式; 条件式; 増減式) {
　// 繰り返す処理
}

for ループの抜け方

break;

if文

if(条件式) {
　// 条件式がtrueだったときの処理
}

while文

while(条件式) {
　//繰り返したい処理
}

GAS共通の記述

ログ出力

Logger.log(data)
Logger.log('%s %s', data1, data2); // 変数を%sに代入できる

Spreadsheetの記述

アクティブなスプレッドシートの取得

SpreadsheetApp.getActiveSpreadsheet()

スプレッドシート名を取得

Spreadsheetオブジェクト.getName()

シート名を指定して取得

Spreadsheetオブジェクト.getSheetByName(シート名)

アクティブなシートを一つ取得

SpreadsheetApp.getActiveSheet()

※ 複数シートが存在する場合、一意にシートを決められない可能性がある

アドレスを指定して、セル範囲を取得する

Sheetオブジェクト.getRange(アドレス)

Rangeオブジェクトから単体セルの値を取得する

Rangeオブジェクト.getValue()

Rangeオブジェクトから複数セルの値を取得する

Rangeオブジェクト.getValues()

行数・列数を指定したセル範囲の取得

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

※行数、列数は指定しない場合１になる

シートの最終行を取得する

Sheetオブジェクト.getLastRow()

※ lastRow は値が存在する最終行

セルに値を代入

Rangeオブジェクト.setValue(値)

Rangeオブジェクトのアドレスを取得する

Rangeオブジェクト.getA1Notation()

Rangeオブジェクトの値削除 & 初期化

Rangeオブジェクト.clear()

Rangeオブジェクトの値削除

Rangeオブジェクト.clearContent()

※書式や背景などは削除されない