カテゴリー: 技術系

スクリプトの権限は、３つ。「オーナー」「編集者」「閲覧者」の３つ。「オーナー」と「編集者」の違いは、プロジェクトの公開をできるかできないかのみ。スクリプトの実行は「閲覧者」に指定されていないと、実行できない。

スクリプトのオーナー権限は、無料のGoogleアカウントや異なるドメイン間では譲渡できない。

キャメル記法は、単語を連結する場合に、2つ目以降の単語の頭文字を大文字にする記法。大文字の部分がラクダ（Camel）のコブのように見えるのが由来。

スネーク記法は、単語を連結する場合に、アンダースコア（ _ ）で連結する記法。

変数はキャメル記法、定数はスネーク記法が一般的。

GASは、Googleのサーバ上で実行されるため（クラウド上で実行されるため）、一部のユーザによって過負荷をかけられないようにスクリプトの実行に際して制限がある。

スクリプトの実行時間やメールの受信者数、カスタム関数実行時間などを制限するハード制限。スクリプトの実行中に制限を超えると、スクリプトはエラーで終了する。

ドキュメントの作成やカレンダーイベント作成など、一日あたりの実行回数を制限する容量制限。容量制限は、ユーザーごとにカウントされており、太平洋標準時（PST）の0時にリセットされる。だいたい日本だと、16時か17時で、サマータイムなどで変わる。

ハード制限の例

• スクリプト実行時間：　1回あたり6分
• カスタム関数実行時間：　1回あたり30秒
• メールの受信者件数：　１メッセージあたり、50件

容量制限の例

• カレンダーイベント作成数：　１日あたり、10,000件
• ドキュメント作成数：　1日あたり、1,500件
• JDBC接続：　1日あたり、50,000件

GASの制限が書かれたページ

– https://developers.google.com/apps-script/guides/services/quotas

GASのスクリプトは、プロジェクトという単位で構成される。GASのスクリプトの拡張子は「.gs」。プロジェクトには、今のところ、GASスクリプトファイルとHTMLファイルのみ含めることができる。

GASのプロジェクトは、「スタンドアロンスクリプト」と「コンテナバインドスクリプト」の2種類がある。「スタンドアロンスクリプト」は、Googleドライブにプロジェクトファイル自体を保存する。一方「コンテナバインドスクリプト」は、スプレッドシートやフォームなどに紐づき、それぞれのアプリ上から作成する。

イメージとしては、「コンテナバインドスクリプト」は、ExcelなどのVBAみたいな感じである。

スクリプトエディタの開き方

スタンドアロンスクリプト

1. Google ドライブを開く
2. 「新規」→「その他」→「アプリを追加」を選択する
3. ダイアログの中から、「Google Apps Script」を探し、「＋接続」をクリックする 「アプリを追加」の作業は一度だけでよい。
4. 「新規」→「その他」→「Google Apps Script」を選択する
5. スクリプトエディタが開く。

コンテナバインドスクリプト

（スプレッドシートの例）

1. スプレッドシートを開く
2. 「ツール」→「スクリプトエディタ」を選択する
3. スクリプトエディタが開く

GASのスクリプトエディタにも、デバック実行と、ブレークポイント設置ができるデバック機能がついている。

ブレークポイント

ブレークポイントは、スクリプトエディタのスクリプト部分のライン表示の数字の横をクリックするとブレークポイントを設置できる。ブレークポイントが設置されると、ライン表示の横に赤い丸がつく。

ブレークポイントを外すときは、ブレークポイントの丸をクリックする。これで、ライン表示から丸が消える。

デバック実行

GASのスクリプトエディタの下にあるツールバーにある「虫マーク」をクリックすると、デバック実行になる。ブレークポイントが設置されているときは、ブレークポイントで、止まる。デバック中は、さまざまな値や状態がスクリプトエディタ上に表示される。

スクリプトの動作確認のために、ログ出力機能がある。

Logger.log() を使うことで、GASでログを出力することができる。

function myFunction() {
  Logger.log('write log'); // ログに出力される
}

出力されているログは、スクリプトエディタで、「メニュー」→「表示」→「ログ」で表示するか、「Ctrl」＋「Enter」（Macは「リンゴ」＋「Enter」）でログが表示される。

なお、Loggerクラスは、GASのBASEサービス。

GASは、Google Apps Scriptの略で、Googleが提供するGoogle Apps（G Suits）で使用できるJava Scriptベースのプログラミング言語。

GASは、Java Scriptをベースにしているが、一般的に使われるJava Scriptと同じではない。Java Scriptの基本部分である基本構文、制御構文、演算子、関数、組み込みオブジェクトのみが対象となる。これらに加えて、Google Appsを操作するための拡張機能で構成される。

ベースに使用しているJava Scriptは、ECMAScriptではなく、JavaScript1.6～1.8の機能。そのため、新しいバージョンで追加された機能はGASでは使用できない可能性がある。

なお、GASは、Googleのサーバ上で実行され、実行環境もGoogleの環境に依存する。