Google Apps Scriptの基本メソッドまとめ

私がよく使用するGASのメソッドをまとめました。使用頻度の高いものを選抜しています。

スプレッドシートの操作

スプレッドシートを取得

const spreadSheet = SpreadsheetApp.getActiveSpreadsheet()

シートを取得

const sheet = spreadSheet.getSheetByName('Sheet Name')

シートを追加

const newSheet = spreadSheet.insertSheet()

シート名を変更

sheet.setName('New Sheet Name')

セルの範囲を指定

// 行番号, 列番号
sheet.getRange(1, 1)

// 行番号, 列番号, 行数, 列数
sheet.getRange(1, 1, 3, 2)

// R1C1形式
sheet.getRange('C1')

// R1C1形式
sheet.getRange('C1:D3')

最終行・最終列を取得

// 最終行を取得
const lastRow = sheet.getLastRow()

// 最終列を取得
const lastColumn = sheet.getLastColumn()

値を取得

const value = sheet.getRange(1, 1).getValue()
const values = sheet.getRange(1, 1, 3, 2).getValues()
const value = sheet.getRange('C1').getValue()
const values = sheet.getRange('C1:D3').getValues()

値を入力

sheet.getRange(1, 1).setValue('foo')
sheet.getRange(1, 1, 3, 2).setValues([['foo', 10], ['bar', 20], ['baz', 30]])
sheet.getRange('C1').setValue('hoge')
sheet.getRange('C1:D3').setValues([['hoge', 10], ['fuga', 20], ['piyo', 30]])

最終行に値を入力

sheet.appendRow(['foo', 10])

色を設定

// 文字色を設定
sheet.getRange(1, 1).setFontColor('#ff0000')

// 背景色を設定
sheet.getRange(1, 1).setBackground('yellow')

Logger

ログを出力

Logger.log('Hello, World!')

Utilities

日付のフォーマット

const date = Utilities.formatDate(new Date(), 'JST', 'yyyy-MM-dd HH:mm:ss')

スリープ

Utilities.sleep(1000)

UrlFetchApp

GET APIリクエスト

const content = UrlFetchApp.fetch(url).getContentText()

POST APIリクエスト

const response = UrlFetchApp.fetch(url, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  payload: JSON.stringify(data)
})

まとめ

他にも多くの機能が提供されているので、公式ドキュメントなどから探してみてください。

参考サイト

最後に

GoQSystemでは一緒に働いてくれる仲間を募集中です！

ご興味がある方は以下リンクよりご確認ください。