Google Apps Script個人的メモ

Script Editor

`/** @OnlyCurrentDoc */`・・現在のSpreadsheetへのアクセスと更新を許可 ※この記述がないと、そのユーザーが持つ全てのSpreadsheetへのアクセスと更新を許可されてしまう。

よく使うメソッド：Spreadsheet Service

SpreadsheetAppクラス

- getActive()・・現在のactive spreadsheetを返す - getActiveSheet()・・spreadsheetでactiveなsheetを返す - flush()・・全ての未決定のspreadsheetの変化を適応させる

Spreadsheetクラス

- addMenu(name, subMenus)・・Spreadsheet UIで新しいメニューを作成 - getLast~()：返り値Integer・・コンテンツを含む最後のcolumn positionやrow positionを返す - getLastColumn() - getLastRow() - getDataRange()：返り値Range・・データが存在するrangeを返す

Sheetクラス

- activate()：返り値Sheet・・あるsheetをactivate sheetに設定 - insertSheet：返り値Sheet - insertSheet() - insertSheet(sheetIndex) - insertSheet(sheetIndex, options) - insertSheet(options) - insertSheet(sheetName) - insertSheet(sheetName, sheetIndex) - insertSheet(sheetName, sheetIndex, options) - insertSheet(sheetName, options) - setName(name)・・sheet nameを設定する - getRange - getRange(row column) ※row, columnは1〜からスタート↔︎配列の場合0〜からスタート - getRange(row, column, numRows) - getRange(row, column, numRows, numColumns) - getRange(a1Notation) - getRangeList(a1Notations) -getDataRange()：返り値Range・・データが存在するrangeを返す - getLast~()：返り値Integer・・コンテンツを含む最後のcolumn positionやrow positionを返す - getLastColumn() - getLastRow() - setFrozen~()：返り値void - setFrozenRows(rows)・・与えられたrowsのindexを固定 - setFrozenColumns(columns)・・与えられたcolumnsのindexを固定 - autoResize〜()：返り値Sheet・・コンテンツに合わせてcolumnやrowのサイズを設定 - autoResizeColumn(columnPosition) - autoResizeColumns(startColumn, numColumns) - autoResizeRows(startRow, numRows) - getSheetByName(name)：返り値Sheet・・与えられた名前のsheetを返す - offset：返り値Range - offset(rowOffset, columnOffset) - offset(rowOffset, columnOffset, numRows) - offset(rowOffset, columnOffset, numRows, numColumns) ※rowOffset・・その範囲のtop-left cellからどれぐらい下に行くのかを表す数 　columnOffset・・その範囲のtop-left cellからどれぐらい右に行くのかを表す数 - clear()：返り値Sheet・・sheetのコンテンツを削除

Rangeクラス

- activate()：返り値Range・・あるrangeをacitivate rangeとして設定 - getLast~()：返り値Integer・・最後のcolumn positionやrow positionを返す - getLastColumn() - getLastRow() - getValue()：返り値Object・・あるrangeのtop-left cellのvalueを返す - getValues()：返り値Object[行のindex][列のindex]・・あるrangeのrectangular gridのvaluesを返す ※行のindex、列のindexは配列ゆえ0〜からスタート - getDataRange()：返り値Range・・データが存在するrangeを返す - setValue(value)：返り値Range・・rangeのvalueを設定 - setValues(value)：返り値Range - setFont~()：返り値Range・・rangeのcolor、fontSize、fontWeightなどを設定

よく使うメソッド：Calendar Service

CalendarAppクラス

- createCalendar：返り値Calendar - createCalendar(name) - createCalendar(name, option)

Calendarクラス

- createEvent：返り値createEvent - createEvent(title, startTime, endTime) - createEvent(title, startTime, endTime, options) - setGuestsCan〜：返り値：CalendarEvent - setGuestsCanInviteOthers(true or false) - setGuestsCanModify(true or false) - setGuestsCanSeeGuests(true or false) - getEventSeriesById(iCalId)：返り値CalendarEventSeries

CalendarEventクラス

- addGuest(email)：返り値CalendarEvent・・eventにguestを追加

よく使うメソッドorプロパティ：Forms Service

FormAppクラス

- create(title)：返り値Form・・新しいformを作って返す - DestinationType・・レスポンスの場所タイプ一覧

Formクラス

- setDestination(type, id)：返り値Form・・レスポンスが保存される場所を設定 - addTextItem()：返り値TextItem・・応答者がa single line of textに入るのを許可する新しいquestionを追加 - addSectionHeaderItem()：返り値SectionHeaderItem - addMultipleChoiceItem()：返り値MultipleChoiceItem

TextItemクラス

- setTitle(title)：返り値TextItem - setRequired(true or false)：返り値TextItem・・応答者がquestionに答えるかどうか設定

MultipleChoiceItemクラス

- setChoiceValues(values)：返り値MultipleChoiceItem・・配列からitemの選択を設定

DestinationTypeプロパティ

- SPREADSHEET・・レスポンスの場所としてのgoogle sheets spreadsheet

よく使うメソッド：Script Service

ScriptAppクラス

- newTrigger(functionName)：返り値：TriggerBuilder・・installable triggerの作成過程を始める

TriggerBuilderクラス

- forSpreadsheet(sheet)：返り値：SpreadsheetTriggerBuilder・・与えられたSpreadsheetに対応するSpreadsheetTriggerBuilderを作成し返す

SpreadsheetTriggerBuilderクラス

- onFormSubmit()：返り値：SpreadsheetTriggerBuilder・・そのspreadsheetに投稿するformがあるとき稼働するtriggerを特定 - create()：返り値：Trigger・・triggerを作り返す

よく使うメソッド：Document Service

DocumentAppクラス

- create(name)：返り値Document

Documentクラス

- addEditor：返り値Document・・与えられたユーザー（たち）をDocumentのeditorリストに追加 - addEditor(emailAddress) - addEditor(user) - addEditors(emailAddresses) - getBody()：返り値Body・・activeなdocument's bodyを取り戻す - insertParagraph(childIndex, paragraph)：返り値Paragraph - insertParagraph(childIndex, text)：返り値Paragraph ※childIndex・・the index at which to insert

Gmail Service

MailAppクラス

- sendEmail(recipient, subject, body)：返り値GmailApp - sendEmail(recipient, subject, body, options)：返り値GmailApp

GmailAttachment

- getAs(contentType)：返り値Blob・・特定のcontent typeに変化したものとしてデータを返す

よく使うメソッド：Properties Service

Properties Serviceを使えばkey-valueペアで単純なデータを保存できる

Script Properties

User Properties

Document Properties

• getProperty(key)・・valueを呼ぶ
• setProperty(key, value)・・valueを保存

よく使うメソッド：javascript

- Number()・・文字列やその他の値をNumber型に変換 - isNaN()・・値が非数かどうかをチェック - toLocaleDateString()・・日時を言語に沿った表現にして文字列を返す - toLocaleTimeString()・・Dateオブジェクトの「時刻」部を表す言語に依存した文字列を返す

よく使う構文：javascript

for var 変数　in オブジェクト

for 変数　of 配列