More than 1 year has passed since last update.

[GAS] インストーラブルトリガーの設定方法など（１）～トリガーの追加から保存、編集、削除の基本プロセス

Posted at 2022-10-25

はじめに

本稿は当方クライアント様への説明用に、内部文書として限定公開していたものを一般公開用に再編集したものとなります。¹

トリガー設定における共通事項

誰がＧＡＳを実行したか、に関わらず、トリガーを設定したユーザーが、トリガーより実行されたＧＡＳの実行ユーザーとして扱われます。

そのため、原則として当該プロジェクトの管理者（もしくは管理用のアカウント）にてトリガー設定をして頂く前提となります。

なお、エラーに関しましては、原則としてエラー通知で確認するか、スクリプトエディタ画面の実行数メニューから確認する必要があります。また、エラー通知は管理者（トリガー設定者）へメールにて通知されますので、通知頻度は適宜設定していただくことになります。

基本プロセス

１．スクリプトエディタを開く

上部メニューに「拡張機能」があるアプリ

現状、スプレッドシート、ドキュメント、スクリプトファイルが該当します。
上部メニュー「拡張機能」からApps Scriptを選択します。

上部メニューに「拡張機能」がないアプリ

現状、スライドが該当しますが、いずれＵＩが統一される可能性があります。
メニューの「ツール」からスクリプトエディタを選択します。

※画面は以前のスプレッドシートのメニュー表示

フォーム

フォーム編集画面より、アカウントアイコンの左側、「…」（三点リーダー）を縦にしたメニューアイコンをクリックし、スクリプトエディタを開きます。

２．トリガー設定メニューを開く

エディタ画面の左側にあるアイコンのうち、目覚まし時計のようなアイコンがトリガー設定用のメニューとなります。
選択し、クリックします。

３．トリガーを追加する

以下、トリガー設定画面になります。他に何もトリガーが設定されていなければ、以下のような状態となります。

画面の右下にある「＋トリガーを追加」ボタンをクリックし、新規にトリガーを追加します。

４．トリガーの設定

トリガー設定画面からボタンクリックで以下のようなモーダルウィンドウが表示されます。画像はスプレッドシートのものとなりますが、①と④はすべてのトリガー設定に共通しています。②イベントのソースを選択は設定するアプリによって選択できる内容が異なり、その選択内容によって、③の項目名及び内容が変わり、さらに小項目が追加されることもあります。

共通の設定内容

①実行する関数：実行させたい関数を選択してください。
④エラー通知設定：好みや状況によって適宜選択してください。

イベントのソース別の設定内容

まず、イベントとは、スクリプトを実行させるための契機、タイミング、処理内容等を指すものとイメージしていただければ結構です。具体的にはスプレッドシートで特定のセルが編集された時、毎日１時間毎に実行する等です。

イベントのソースは現在以下の４種類があり、それぞれに設定できるイベントの種類、内容があります。なお、時間主導型に関しましては、項目数が多く、説明も長くなりますので、別の機会にて解説させていただきます。

スプレッドシートから
カレンダーから
フォームから
時間主導型

1. イベントのソースを選択「スプレッドシートから」

スプレッドシートのみに適用されます。

イベントの種類

起動時（Open）：当該スプレッドシートを開いた時に実行させたい場合に選択します。
編集時（Edit）：当該スプレッドシートのセルやセル範囲単位の編集確定時に実行させたい場合に選択します。
変更時（Change）：当該スプレッドシートの行や列の削除など、シート単位の編集確定時に実行させたい場合に選択します。シンプルトリガーのonSelectionChangeとは別物です。
フォーム送信時（Form submit）：当該スプレッドシートに紐付けられているフォームデータが送信された時に実行させたい場合に選択します。