イベント オブジェクト

シンプルなトリガーとインストール可能なトリガーを使用すると、特定のイベントが発生したときに Apps Script が関数を自動的に実行できます。トリガーが起動すると、Apps Script はイベント オブジェクトを引数として関数に渡します。これは通常、e と呼ばれます。イベント オブジェクトには、トリガーがトリガーされたコンテキストに関する情報が含まれます。たとえば、次のサンプルコードは、イベント オブジェクトを使用して編集されたセルを特定する Google スプレッドシート スクリプトのシンプルな onEdit(e) トリガーを示しています。

function onEdit(e){
  // Set a comment on the edited cell to indicate when it was changed.
  var range = e.range;
  range.setNote('Last modified: ' + new Date());
}

このページでは、さまざまなタイプのトリガーのイベント オブジェクトのフィールドについて詳しく説明します。

インストール可能なトリガーによって生成されたイベントには、イベントを生成したトリガーを識別する triggerUid が含まれています。これは、複数のインストール可能なトリガーを含むスクリプトに役立ちます。

Google スプレッドシートのイベント

Google スプレッドシート固有のさまざまなトリガーを使用すると、スプレッドシート内のユーザーの操作にスクリプトが応答できます。

開く （シンプルかつインストール可能）。
authMode	ScriptApp.AuthMode 列挙型の値。 LIMITED
source	スクリプトがバインドされている Google スプレッドシート ファイルを表す Spreadsheet オブジェクト。 Spreadsheet
triggerUid	このイベントを生成したトリガーの ID（インストール可能なトリガーのみ）。 4034124084959907503
user	アクティブなユーザーを表す User オブジェクト（利用可能な場合）（複雑なセキュリティ制限に応じて）。 [e-mail]

変更 （installable）
authMode	ScriptApp.AuthMode 列挙型の値。 FULL
changeType	変更のタイプ（EDIT、INSERT_ROW、INSERT_COLUMN、REMOVE_ROW、REMOVE_COLUMN、INSERT_GRID、REMOVE_GRID、FORMAT、または OTHER）。 INSERT_ROW
source	スクリプトがバインドされている Google スプレッドシート ファイルを表す Spreadsheet オブジェクト。 Spreadsheet
triggerUid	このイベントを生成したトリガーの ID。 4034124084959907503
user	アクティブなユーザーを表す User オブジェクト（利用可能な場合）（複雑なセキュリティ制限に応じて）。 [e-mail]

編集 （シンプルかつインストール可能）。
authMode	ScriptApp.AuthMode 列挙型の値。 LIMITED
oldValue	編集前のセル値（存在する場合）。編集対象の範囲が 1 つのセルの場合にのみ使用できます。セルに以前のコンテンツがない場合、未定義になります。 1234
range	編集されたセルまたはセル範囲を表す Range オブジェクト。 Range
source	スクリプトがバインドされている Google スプレッドシート ファイルを表す Spreadsheet オブジェクト。 Spreadsheet
triggerUid	このイベントを生成したトリガーの ID（インストール可能なトリガーのみ）。 4034124084959907503
user	アクティブ ユーザーを表す User オブジェクト（利用可能な場合）（複雑なセキュリティ制限に基づく）。 [e-mail]
value	編集後の新しいセル値。編集対象の範囲が単一セルの場合にのみ使用できます。 10

フォームの送信 （installable）
注意: SpreadsheetTriggerBuilder とともにこのフォーム送信トリガーを使用してください。
authMode	ScriptApp.AuthMode 列挙型の値。 FULL
namedValues	フォーム送信の問題の名前と値を含むオブジェクト。 { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] }
range	編集されたセルまたはセル範囲を表す Range オブジェクト。 Range
triggerUid	このイベントを生成したトリガーの ID。 4034124084959907503
values	スプレッドシートに表示されているのと同じ順序の値を含む配列。 ['2015/05/04 15:00', '[e-mail]', 'Bob', '27', 'Bill', '28', 'Susan', '25']

Google ドキュメントのイベント

トリガーを使用すると、ユーザーがドキュメントを開いたときに Google ドキュメントが応答できます。

開く （シンプルかつインストール可能）。
authMode	ScriptApp.AuthMode 列挙型の値。 LIMITED
source	スクリプトがバインドされている Google ドキュメント ファイルを表す Document オブジェクト。 Document
triggerUid	このイベントを生成したトリガーの ID（インストール可能なトリガーのみ）。 4034124084959907503
user	アクティブなユーザーを表す User オブジェクト（利用可能な場合）（複雑なセキュリティ制限に応じて）。 [e-mail]

Google スライドのイベント

トリガーを使用すると、ユーザーがプレゼンテーションを開いたときに Google スライドが応答できます。

開く （シンプル）
authMode	ScriptApp.AuthMode 列挙型の値。 LIMITED
source	スクリプトがバインドされている Google スライド ファイルを表す Presentation オブジェクト。 Presentation
user	アクティブ ユーザーを表す User オブジェクト（利用可能な場合）（複雑なセキュリティ制限に基づく）。 [e-mail]

Google フォームのイベント

Google フォーム固有のトリガーを使用すると、ユーザーがフォームを編集したときや回答を送信したときにスクリプトを実行できます。

開く *（シンプルかつインストール可能）
authMode	ScriptApp.AuthMode 列挙型の値。 LIMITED
source	スクリプトがバインドされている Google フォーム ファイルを表す Form オブジェクト。 Form
triggerUid	このイベントを生成したトリガーの ID（インストール可能なトリガーのみ）。 4034124084959907503
user	アクティブ ユーザーを表す User オブジェクト（利用可能な場合）（複雑なセキュリティ制限に基づく）。 [e-mail]

* このイベントは、ユーザーが回答のためにフォームを開いたときに発生しますが、編集者がフォームを開いて変更を行ったときに発生します。

フォームの送信 （installable）
注意: このフォーム送信トリガーは FormTriggerBuilder で使用してください。
authMode	ScriptApp.AuthMode 列挙型の値。 FULL
response	フォーム全体に対するユーザーの回答を表す FormResponse オブジェクト。 FormResponse
source	スクリプトがバインドされている Google フォーム ファイルを表す Form オブジェクト。 Form
triggerUid	このイベントを生成したトリガーの ID。 4034124084959907503

Google カレンダーの予定

カレンダー トリガーは、ユーザーのカレンダーの予定が更新（作成、編集、削除）されると呼び出されます。

これらのトリガーでは、どのイベントが変更されたか、どのように変更されたかはわかりません。代わりに、カレンダーの最新の変更を取得するために、コードで増分同期オペレーションを行う必要があることを示しています。この手順の詳細については、Calendar API のリソースの同期ガイドをご覧ください。

Apps Script でカレンダーと同期するには、次の操作を行います。

1. スクリプト プロジェクトでカレンダー拡張サービスを有効にします。組み込みのカレンダー サービスでは、このワークフローでは不十分です。
2. 同期するカレンダーを決定します。このようなカレンダーごとに、Calendar Advanced Service の Events.list() メソッドを使用して初期同期オペレーションを実行します。
3. 最初の同期の結果として、そのカレンダーの nextSyncToken が返されます。このトークンを後で使用するために保存してください。
4. カレンダー イベントの変更を示す Apps Script の EventUpdated トリガーが起動したら、保存された nextSyncToken を使用して、影響を受けるカレンダーの増分同期を実行します。これは基本的に別の Events.list() リクエストですが、nextSyncToken を指定すると、前回の同期以降に変更されたイベントのみにレスポンスが制限されます。
5. 同期のレスポンスを確認して、更新されたイベントを把握し、コードが適切に応答するようにします。たとえば、変更の記録、スプレッドシートの更新、メール通知の送信などの操作を行うことができます。
6. そのカレンダー用に保存した nextSyncToken を、増分同期リクエストで返されたものに変更します。これにより、次の同期オペレーションでは最新の変更のみが返されます。

注意: サーバーによって同期トークンが無効になり、410 エラーが発生することがあります。このような場合、コードは完全同期を行い、そのカレンダーに保存されている同期済みデータとトークンをすべて置き換える必要があります。

EventUpdated （インストール可能）
authMode	ScriptApp.AuthMode 列挙型の値。 FULL
calendarId	イベントの更新が発生したカレンダーの文字列 ID。 [e-mail]
triggerUid	このイベントを生成したトリガーの ID。 4034124084959907503

Google Workspace アドオンのイベント

onInstall() トリガーは、ユーザーがアドオンをインストールすると自動的に実行されます。

インストール （シンプル）
authMode	ScriptApp.AuthMode 列挙型の値。 FULL

Google Chat アプリのイベント

Google Chat のイベント オブジェクトについては、Google Chat アプリでの操作を受信して応答するをご覧ください。

時間主導型イベント

時間ドリブン トリガー（クロックトリガーとも呼ばれます）を使用すると、スクリプトを特定の時間または繰り返しの間隔で実行できます。

時間主導型（インストール可能）
authMode	ScriptApp.AuthMode 列挙型の値。 FULL
day-of-month	1～31 の範囲。 このプロパティ名にはダッシュが含まれているため、ドット表記ではなく e['day-of-month'] を使用してアクセスする必要があります。 31
day-of-week	1（月曜日）から 7（日曜日）までの範囲。 このプロパティ名にはダッシュが含まれているため、ドット表記ではなく e['day-of-week'] でアクセスする必要があります。 7
hour	0～23。 23
minute	0～59 の範囲。 59
month	1～12。 12
second	0～59 の範囲。 59
timezone	タイムゾーン。 UTC
triggerUid	このイベントを生成したトリガーの ID。 4034124084959907503
week-of-year	1～52 の範囲。 このプロパティ名にはダッシュが含まれているため、ドット表記ではなく e['week-of-year'] を使用してアクセスする必要があります。 52
year	年です。 2015