【GAS】スプレッドシートのトーストメッセージ機能まとめ【サンプルソース付】

GAS開発者向けにスプレッドシートのトーストメッセージ機能をすべてまとめました。

スプレッドシートを扱ってる時、ポップアップウィンドウでちょっとしたメッセージを表示したい時はきっとあります。

なぜ「トースト」か。食パンが焼きあがったようにポンっと出てくるトースターが由来らしいです。なんかかわいいですね。

表示時間指定もできます。何か大切なことを通知する場合など、使いどころをイメージしてぜひ使ってみてください。

トーストメッセージに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Google Apps Script スプレッドシート基礎リファレンス
スプレッドシートクラス[Spreadsheet]のトースト（ポップアップ）メッセージ
最後に

Google Apps Script スプレッドシート基礎リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】

GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知...

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】

Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの...

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

リンク

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。

スプレッドシートクラス[Spreadsheet]のトースト（ポップアップ）メッセージ

スプレッドシートのトーストメッセージメソッドです。

トーストメッセージ表示1[toast(メッセージ)]

toast(msg)
スプレッドシートの右下隅に、指定されたメッセージを含むポップアップウィンドウを表示します。

function toast1Sample() {
  // 「Task started」というメッセージでポップアップを表示します。
  SpreadsheetApp.getActiveSpreadsheet().toast('Task started');
}

Parameters
名前	タイプ	説明
msg	String	トーストに表示されるメッセージ。

トーストメッセージ表示2[toast(メッセージ, タイトル)]

toast(msg, title)
スプレッドシートの右下隅に、指定されたメッセージとタイトルを含むポップアップウィンドウを表示します。

function toast2Sample() {
  // タイトルが "Status"、メッセージが "Task started"のポップアップを表示します。
  SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');
}

Parameters
名前	タイプ	説明
msg	String	トーストに表示されるメッセージ。
title	String	トーストのオプションのタイトル。

トーストメッセージ表示3[toast(メッセージ, タイトル, タイムアウト秒)]

toast(msg, title, timeoutSeconds)
スプレッドシートの右下隅に、指定されたタイトルとメッセージを含むポップアップウィンドウを表示します。このウィンドウは一定期間表示されたままになります。

function toast3Sample() {
  // タイトルが "Status"、メッセージが "Task started"の3秒間のポップアップを表示します。
  SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);
}

Parameters
名前	タイプ	説明
msg	String	トーストに表示されるメッセージ。
title	String	トーストのオプションのタイトル。
timeoutSeconds	Number	秒単位のタイムアウト。 nullの場合、トーストのデフォルトは5秒です。マイナス秒を指定した場合はユーザが閉じるまで表示されます。