イベント オブジェクト

シンプルなトリガーとインストール可能なトリガーを使用すると、特定のイベントが発生したときに 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());
}

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

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

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

LIMITED

Spreadsheet

4034124084959907503

amin@example.com

FULL

INSERT_ROW

Spreadsheet

4034124084959907503

amin@example.com

LIMITED

1234

Range

Spreadsheet

4034124084959907503

amin@example.com

10

FULL

{
  'First Name': ['Jane'],
  'Timestamp': ['6/7/2015 20:54:13'],
  'Last Name': ['Doe']
}

Range

4034124084959907503

['2015/05/04 15:00', 'amin@example.com', 'Bob', '27', 'Bill',
'28', 'Susan', '25']

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

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

LIMITED

Document

4034124084959907503

amin@example.com

Google スライドのイベント

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

LIMITED

Presentation

amin@example.com

Google フォームのイベント

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

LIMITED

Form

4034124084959907503

amin@example.com

* このイベントは、ユーザーがフォームを開いて回答したときに発生するのではなく、エディタがフォームを開いて変更したときに発生します。

FULL

FormResponse

Form

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 を、増分同期リクエストによって返された nextSyncToken で更新します。これにより、次の同期オペレーションで最新の変更のみが返されるようになります。

FULL

susan@example.com

4034124084959907503

Google Workspace アドオン イベント

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

FULL

Google Chat アプリのイベント

Google Chat のイベント オブジェクトについて詳しくは、Google Chat アプリでインタラクションを受け取って応答するをご覧ください。

時間主導型イベント

時間主導型トリガー（クロック トリガーとも呼ばれます）を使用すると、特定の時間または一定の間隔でスクリプトを実行できます。

FULL

31

7

23

59

12

59

UTC

4034124084959907503

52

2015