GASで業務効率化ツールや自動化スクリプトを作れるようになってくると、「プログラムの処理が終わったことを画面上で分かりやすく通知したい!」「大切なデータを一括削除する前に『本当に実行しますか?』という確認画面を出したい!」と思ったことはありませんか?
これまでは、第1回【Logger.logの使い方】で学んだ Logger.log() を使って、エディタの裏側(実行ログ)にメッセージを出力して確認していましたよね。しかし、スプレッドシートを普段使っている同僚や自分自身に対して、画面上に分かりやすくポップアップを出して通知したり、ボタンで意志確認をしたりするには、ログ画面ではなくスプレッドシートの画面上にメッセージを表示する必要があります。
そこで今回マスターするのが、画面上にダイアログ(ポップアップウィンドウ)を表示させる超必須メソッド Ui.alert() です!
今回は、Ui.alert() の基本構造から、「はい / いいえ」ボタンを使った処理の分岐、誤操作を防ぐ確認ダイアログの実践例まで、初心者向けにどこよりも分かりやすく解説していきますね!
1. そもそも Ui.alert() とは? Logger.log() との違い
Ui.alert() は、現在開いているスプレッドシートの画面上に、メッセージや確認用ボタンがついたポップアップ画面(ダイアログ)を表示させる命令です。
まずは、第1回で学んだ Logger.log() との違いを整理しておきましょう。
| 項目 | Logger.log() | Ui.alert() |
| 表示場所 | エディタ裏側の「実行ログ」エリア | スプレッドシートの画面中央(ポップアップ) |
| 主な対象者 | プログラムを作る開発者自身 | スプレッドシートを操作するユーザー(同僚や自分) |
| 主な目的 | 変数の中身やエラーの動作確認 | 処理完了の通知、データ削除前の実行確認 |
| ユーザー操作 | 不要(ログが出るだけ) | ボタンを押すまで処理が一時停止する |
「案内係」と「メッセージカード」でイメージしよう!
スプレッドシートの画面上にポップアップを表示させるには、まずGASに対して「画面操作を担当する案内係(UIオブジェクト)」を呼んでくる必要があります。
SpreadsheetApp.getUi()➡ 画面操作を担当する「案内係(UI)」を連れてくるui.alert("メッセージ")➡ 案内係に頼んで「メッセージカード(ダイアログ)」を画面に差し出してもらう
この2段階のステップを踏むことで、ユーザーの画面上にきれいなポップアップ画面を表示させることができます!
2. Ui.alert() の基本文法と3つの書き方パターン
Ui.alert() には、やりたいことに合わせて使い分けられる 3つの書き方パターン が用意されています。どれもよく使うので、基本の形を押さえておきましょう!
パターン①:シンプルにメッセージだけを表示する(通知用)
var ui = SpreadsheetApp.getUi();
ui.alert("買い出しリストの更新が完了しました!");
- 特徴:一番シンプルな書き方です。[ OK ]ボタンが1つだけついたダイアログが表示されます。処理が終わったことを知らせる「完了通知」にぴったりです。
パターン②:タイトルと本文を分けて表示する
var ui = SpreadsheetApp.getUi();
ui.alert("処理完了", "買い出しリストの更新が完了しました!", ui.ButtonSet.OK);
- 特徴:1番目の引数に「タイトル」、2番目に「本文」、3番目に「ボタンの種類」を指定します。ダイアログの上部に大きな見出しが付くため、より丁寧で読みやすい通知になります。
パターン③:選択ボタンを付けて、押されたボタンで処理を分ける(超重要!)
var ui = SpreadsheetApp.getUi();
// 1. ダイアログを表示し、ユーザーが押したボタンの結果を変数 response に受け取る
var response = ui.alert("実行確認", "本当にデータを削除しますか?", ui.ButtonSet.YES_NO);
// 2. 押されたボタンによって処理を分ける(if文)
if (response == ui.Button.YES) {
// [はい]が押されたときの処理
} else {
// [いいえ]が押されたときの処理
}
- 特徴:
ui.ButtonSet.YES_NO([はい][いいえ]ボタン)を配置し、ユーザーがどちらのボタンをクリックしたかを判定できます。誤操作を防ぎたい重要処理の前に必須となるテクニックです!
3. STEP1:準備!「札幌オフィス・セコマ買い出しリクエスト表」を作成しよう
それでは、実際に手元のスプレッドシートを使ってコードを動かしてみましょう!
今回は、札幌オフィスで残業前やランチ時によく発生する「セイコーマート(セコマ)の買い出しリクエスト一覧」を想定したシートを用意します。
手順
- 新しいGoogleスプレッドシートを作成し、ファイル名を 「札幌オフィス業務管理」 にします。
- 画面下のシートタブ名を 「セコマ買い出し」 に変更します。
- 以下のように表データを入力してください。
| A | B | C | D | |
| 1 | 依頼者 | 商品名 | 数量 | 状態 |
| 2 | 佐藤 | ホットシェフ カツ丼 | 1 | 完了 |
| 3 | 鈴木 | フライドチキン | 2 | 完了 |
| 4 | 高橋 | 和菓子(くるみ大福) | 3 | 完了 |
- 入力が完了したら、「セコマ買い出し」シートを開いた状態にしておきます。
4. STEP2:【実践】「本当に削除しますか?」の誤操作防止ダイアログを作ろう!
準備ができたら、GASのエディタを開いてコードを書いていきましょう。
今回は、溜まった買い出しデータを一括クリアする前に、「本当にデータを消去しますか?」と警告を出し、[はい]が押されたときだけデータを消去するスクリプトを作成します。
データ消去には、第8回【Range.clearContent】で学んだセルのデザインを残して文字だけ消す命令を活用しますよ!
1. コードを入力する
スプレッドシートのメニューバーから 「拡張機能」 > 「Apps Script」 を開き、エディタ画面のコードをすべて消して以下を貼り付けます。
function clearShoppingListWithConfirm() {
// ① スプレッドシートとUI(案内係)を取得する
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getActiveSheet();
var ui = SpreadsheetApp.getUi();
// ② 確認用のアラート(ポップアップ)を表示し、押されたボタンを取得する
var response = ui.alert(
"データ一括削除の確認",
"買い出しリストのデータをすべて消去します。\n本当に実行してもよろしいですか?",
ui.ButtonSet.YES_NO
);
// ③ ユーザーが押したボタンによって処理を分岐させる
if (response == ui.Button.YES) {
// [はい]が押された場合:第8回で学んだ clearContent() でデータ(A2:D4)を消去
sheet.getRange("A2:D4").clearContent();
// 消去完了のポップアップを通知
ui.alert("処理完了", "リストのデータを正常に消去しました。", ui.ButtonSet.OK);
} else {
// [いいえ]または[閉じる(✕)]が押された場合:処理を安全に中断
ui.alert("キャンセル", "削除処理をキャンセルしました。", ui.ButtonSet.OK);
}
}
2. コードを1行ずつ丁寧に解説!
var ui = SpreadsheetApp.getUi();- スプレッドシートの画面操作を担当する UI オブジェクト(案内係)を連れてきます。
ui.ButtonSet.YES_NO- ポップアップ画面に[はい]と[いいえ]の2つのボタンを並べる設定です。
"\n"(改行)- メッセージテキストの中で改行したいときは、半角の
\nを挟みます。これで読みやすい2行のメッセージになります。
- メッセージテキストの中で改行したいときは、半角の
if (response == ui.Button.YES)- 変数
responseに入った「押されたボタン」がui.Button.YES([はい]ボタン)と等しいかどうかを判定しています。
- 変数
sheet.getRange("A2:D4").clearContent();- 第8回で学んだ命令ですね!1行目の見出しは残したまま、A2〜D4セルに入っているデータだけを安全に消去します。
3. 保存して実行する
- エディタ上部の 「保存アイコン(フロッピーディスク)」 をクリックします。
- 実行する関数が
clearShoppingListWithConfirmになっていることを確認し、「実行」 ボタンをクリックします。 - スプレッドシートの画面タブに切り替えてみましょう!
スプレッドシートの画面中央に、「データ一括削除の確認」 というポップアップ画面が表示されていますね!
- [いいえ]を押した場合 ➡ 「削除処理をキャンセルしました。」と表示され、スプレッドシートのデータはそのまま保持されます。
- [はい]を押した場合 ➡ A2:D4のデータが一瞬できれいに消去され、「リストのデータを正常に消去しました。」という完了ダイアログが出ます!
画面上でしっかり確認を挟むことで、うっかり大切なデータを消してしまう事故を100%防ぐことができるようになりました!
5. STEP3:実務で差がつく!Ui.alert() の活用パターン3選
単に確認ダイアログを出すだけでなく、実務でよく使われる3つの発展的な書き方をマスターしておきましょう。
応用①:選択できる「ボタンのセット(ButtonSet)」一覧
ui.alert() で指定できるボタンの組み合わせと、戻り値(押されたボタン)の対応表です。状況に合わせて使い分けましょう。
| 指定する ButtonSet | 表示されるボタン | 判定に使う定数(ui.Button) |
ui.ButtonSet.OK | [ OK ] | ui.Button.OK |
ui.ButtonSet.OK_CANCEL | [ OK ] [ キャンセル ] | ui.Button.OK, ui.Button.CANCEL |
ui.ButtonSet.YES_NO | [ はい ] [ いいえ ] | ui.Button.YES, ui.Button.NO |
ui.ButtonSet.YES_NO_CANCEL | [ はい ] [ いいえ ] [ キャンセル ] | ui.Button.YES, ui.Button.NO, ui.Button.CANCEL |
応用②:計算結果や件数を動的にメッセージへ組み込む
固定の文字列だけでなく、プログラムで計算した数字などをメッセージの中に埋め込むと、より実践的なツールになります。
function notifyTaskCount() {
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var ui = SpreadsheetApp.getUi();
// データが入っている最終行を取得(第11回参照)
var lastRow = sheet.getLastRow();
var count = lastRow - 1; // 見出し行を除くデータ件数
// 動的な件数をメッセージにセット!
ui.alert("現在の注文状況", "現在、セコマの買い出しリクエストは「 " + count + " 件 」届いています!", ui.ButtonSet.OK);
}
応用③:シートを開いた瞬間に連絡事項をポップアップ表示する
第21回【onOpen(e)】で学ぶ「シンプルトリガー」と組み合わせると、同僚がスプレッドシートを開いた瞬間に、自動で連絡事項を画面上にポップアップさせることができます!
function onOpen(e) {
var ui = SpreadsheetApp.getUi();
ui.alert(
"【札幌オフィス連絡事項】",
"本日15時にセコマへ買い出しに行きます。\n追加のリクエストがある方は14時30分までに入力してください!",
ui.ButtonSet.OK
);
}
6. 初心者が絶対につまずく!5大トラップと完全対処法
Ui.alert() を使う際、プログラミング初心者やGAS学習者が非常によく遭遇するエラーや落とし穴を5つ厳選しました。
トラップ1:SpreadsheetApp.getUi() を呼び出さずにいきなり Ui.alert() と書く
ついついやってしまいがちなのが、以下のような書き方です。
// ✕ エラーになる書き方(getUiをしていない)
Ui.alert("処理が完了しました!");
// エラーメッセージ:ReferenceError: Ui is not defined
Ui というオブジェクトは、そのままでは存在しません。必ず var ui = SpreadsheetApp.getUi(); で案内係を呼び出してから、ui.alert(...) と呼び出すルールを徹底しましょう!
トラップ2:時間主導型トリガー(タイマー実行)の中で使ってエラーになる
【超重要!】 Ui.alert() は、「画面を開いてパソコンを操作している人間がいる」ときにしか動かすことができません。
そのため、夜間自動実行などの「時間主導型トリガー(タイマー実行)」に設定したスクリプトの中で Ui.alert() を呼び出すと、以下のようなエラーが発生して処理が失敗します。
Exception: Cannot call SpreadsheetApp.getUi() from this context.
(訳:この実行環境から SpreadsheetApp.getUi() を呼び出すことはできません。)
タイマー実行させる自動化スクリプトでは画面ポップアップは使えませんので、代わりに Gmailへの通知メール送信 や Slack / LINE への自動送信 を利用しましょう!
トラップ3:ui.Button.YES の大文字・小文字を間違えて判定がすり抜ける
JavaScript(GAS)は英大文字と小文字を厳しく区別します。
- ✕
ui.button.yes(すべて小文字) - ✕
ui.Button.Yes(Yesの頭だけ大文字) - ◯
ui.Button.YES(Button は頭大文字、YES はすべて大文字)
スペルを間違えると、[はい]ボタンを押しても if 文の判定を正しく通過せず、意図しない挙動になってしまいます。
トラップ4:ダイアログが開いている間、プログラムが一時停止することを知らない
ui.alert() が実行されて画面にポップアップが出ている間、GASの処理はユーザーがボタンを押すまでその行で一時停止(ストップ) します。
そのため、例えば for 文などの繰り返し処理(ループ)の中で ui.alert() を書いてしまうと、データの1行ごとに毎回ポップアップが出てボタンを押さなければ進まない という地獄のような状態になってしまいます。
アラートメッセージは、処理の「一番最初(確認)」か「一番最後(完了報告)」で1回だけ出すのが基本テクニックです!
トラップ5:改行記号の向きを間違えてそのまま文字が表示される
メッセージ内で改行しようとして、スラッシュ /n と書いてしまったり、全角の ¥n で書いてしまうミスも多く見られます。
- ✕
"1行目/n2行目"➡ そのまま「1行目/n2行目」と表示される - ◯
"1行目\n2行目"➡ 正しく改行されて表示される
キーボードの半角バックスラッシュ(環境によっては半角の円マーク \)+ 小文字 n の組み合わせである \n を使うようにしましょう。
7. 今回のまとめと次回予告
今回は、スプレッドシートの画面上にメッセージや確認画面を表示させる Ui.alert() を徹底解説しました。
今日の重要ポイントおさらい
SpreadsheetApp.getUi()で画面操作の「案内係(UI)」をまず呼び出すui.alert("メッセージ")で簡単に画面ポップアップが出せるui.ButtonSet.YES_NOを使えば「はい/いいえ」の確認画面が作れる- ユーザーが押したボタン(
ui.Button.YES)をif文で判定して処理を安全に分岐させる - 画面を開いている人がいない「タイマー実行」では Ui.alert は使えない
これで、一方的に処理を実行するだけでなく、使う人にやさしい「対話型の自動化ツール」が作れるようになりましたね!
さて、メッセージや確認ボタンが出せるようになったら、次にやりたくなるのは 「画面上でユーザーに直接テキストや数字を入力してもらい、その値を使って処理すること」 ですよね!
次回(第26回)は、ダイアログの中に文字や数値の入力ボックスを表示させる Ui.prompt()(プロンプト) を解説します!
「担当者名」や「検索したい日付」を画面から入力してもらい、スプレッドシートを自在に操作するさらに高度なツールを作成していきましょう。ぜひお楽しみに!

