それぞれのシステムの詳細や違いを見る前に、イベントに使う用語を見てみよう。イベントとは一般的に起こった事柄と考えられてる。例を下に示すと

• 時計が一時を指した
• スプレッドシートが開かれた
• スプレッドシートが編集された
• フォームが送信された

• スクリプトがスクリプトギャラリーからインストールされた時、onInstall関数をつかう
• スプレッドシートが開かれた時、onOpen関数を使う
• スプレッドシートが編集された時、onEdit関数を使う

• スクリプトを含んだスプレッドシートを編集するにはそのスプレッドシートは開かれなければならない
• シンプルイベントハンドラーは現在のユーザーが誰かを知ることができない
• シンプルイベントハンドラーはユーザー認証が必要なサービスにアクセスできない。例えば、Google翻訳サービスは匿名可能なので、シンプルイベントハンドラーでもアクセスできるが、カレンダー、メールやサイトは匿名不可なのでアクセスできない
• シンプルイベントハンドラーは今開いてるスプレッドシートを更新できるが、他のスプレッドシートにはアクセスできない

イベントセキュリティの更なる情報は Understanding Permissions and Script Execution.

onOpen()

// onOpen関数はスプレッドシートが開かれる度に自動的に実行される
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var menuEntries = [];
  //ユーザーが "addMenuExample" メニューを選択して、 "Menu Entry 1"をクリックした時 function1関数は実行される.
  menuEntries.push({name: "Menu Entry 1", functionName: "function1"});
  menuEntries.push({name: "Menu Entry 2", functionName: "function2"});
  ss.addMenu("addMenuExample", menuEntries);
}

onEdit(event)

function onEdit(event)
{
  var ss = event.source.getActiveSheet();
  var r = event.source.getActiveRange();
  r.setComment("Last modified: " + (new Date()));
}

onInstall()

// onInstallからonOpenを呼ぶ
function onInstall()
{
  onOpen();
}
// その後スクリプトが開かれたらonOpenが実行されることになる
function onOpen()
{
// コード
}

• 特定の時間に達した時　年月日時、分、秒を指定できる。
• フォームが送信された時
• スプレッドシートが編集された時　シンプルイベントハンドラーのonEditとの違いは、インストール可能イベントハンドラーは、インストールしたユーザーとして動作する。
• スプレッドシートが開かれた時　シンプルイベントハンドラーのonOpenとの違いは、インストール可能イベントハンドラーは、インストールしたユーザーとして動作する。

• インストールしたユーザーとして実行される。イベントを引き起こしたユーザーとしてではなく。
• インストールしたユーザーがアクセスできる全てのサービスに潜在的にアクセス可能である。
• シンプルイベントハンドラーのようなアクセス制限がない、全てのことができるスクリプトである。
• どのユーザーがイベントを引き起こしたかわからない可能性がある。時間イベントには重要なことではないが、ドキュメント変更イベントにおいて誰がドキュメントを変更したのかはわからないことになるだろう。
• スクリプトをトリガーによって実行するのにスプレッドシートが開いてある必要がない。

トリガーがインストールしたユーザーのアイデンティティで動くのは、安全性の理由からである。あなたがインストールしたトリガーを、共同作業者が実行したとしても、あなたのアイデンティティでスクリプトは実行される。更なるこれに関する情報は、Understanding Permissions and Script Execution

イベントハンドラーをインストールするのに、カレンダーやメールやその他のサービスの認証が求められるかもしれないが、それはスクリプトが何をするかによる。

スクリプトをある時間、もしくは希望する時間に実行するには：

1. Googleドキュメントから新たなスプレッドシートを作成
2. スプレッドシートを保存
3. ツール＞スクリプトエディタを選択
4. リソース＞現在のスクリプトのトリガーを選択  No triggers set up. Click here to add one nowのメッセージと一緒にパネルが表示される
5. リンクをクリック
6. 実行の下のところから、スケジュールで実行したい関数を選択
7. Eventsの下から、Timve-drivenを選択
8. 最初のドロップダウンリストから、 Week timer, Day timer, Hour timer, Minutes timerのいずれかを選択　そうすると選んだものによって一つ、または二つのリストが現われる。トリガーと関数をテストしたいなら、何日何時間も待たなくていいように、短い時間を選択しよう。
1. Week timer　　 曜日と時間を選択
2. Day timer　　　 時間を選択
3. Hour timer　　　時間の間隔を選択
4. Minutes timer　分の間隔を選択
9. 保存をクリック
10. タイムゾーンを選択するには、ファイル＞プロジェクトのプロパティからタイムゾーンを設定する

• スプレッドシートを開く
• スプレッドシートを編集する
• フォームを送信する

あるアクションがなされたらスクリプトが実行されるには：

1. Google　ドキュメントを開いて、新しいスプレッドシートを作成する
2. 無題スプレッドシートをクリックして名前を変える
3. ツール＞スクリプトエディタを選択
4. リソース＞現在のスクリプトのトリガーを選択  No triggers set up. Click here to add one nowのメッセージと一緒にパネルが表示される
5. リンクをクリック
6. 実行の下のところから、トリガーで実行したい関数を選択
7. Eventsの下から、From Spreadsheetを選択
8. 次のドロップダウンリストからOn open,On edit、On formのいずれかから選択
9. 保存をクリック

---

更に詳細なイベント

// フォームは二つのフィールドを持つものとする (name and age)
function onFormSubmit(e) {
 var timestamp = e.values[0];
 var name = e.values[1];
 var age = e.values[2];
 // namedValues はAppsユーザーの送信者のみ利用可能で
 // フォームは送信する前にサインインが必要となる
 var submitter = e.namedValues["Username"];

 MailApp.sendEmail("email_username", "form submitted",
                   name + ", age " + age + " submitted by " + submitter + " on " + timestamp + ". ");
}

イベントハンドラーのエラー

function myFunction(){
     try {
          // script code here
      } 
   catch (e) {
          MailApp.sendEmail("youremail@example.com", "Error report", e.message);
      }
}