Class Browser

ブラウザ

このクラスは、Google スプレッドシートに固有のダイアログ ボックスにアクセスできるようにします。

このクラスのメソッドは、Google スプレッドシートのコンテキストでのみ使用できます。代わりに Google Workspace ダイアログを使用してください。

関連情報

プロパティ

プロパティタイプ説明
ButtonsButtonSet

メソッド

メソッド戻り値の型概要
inputBox(prompt)Stringユーザーのブラウザにテキスト入力ボックスを含むダイアログ ボックスをポップアップ表示します。
inputBox(prompt, buttons)Stringユーザーのブラウザにテキスト入力ボックスを含むダイアログ ボックスをポップアップ表示します。
inputBox(title, prompt, buttons)Stringユーザーのブラウザにテキスト入力ボックスを含むダイアログ ボックスをポップアップ表示します。
msgBox(prompt)String指定されたメッセージと [OK] ボタンを含むダイアログ ボックスをユーザーのブラウザに表示します。
msgBox(prompt, buttons)String指定されたメッセージと指定されたボタンを含むダイアログ ボックスをユーザーのブラウザに表示します。
msgBox(title, prompt, buttons)String指定されたタイトル、メッセージ、ボタンを含むダイアログ ボックスをユーザーのブラウザにポップアップ表示します。

詳細なドキュメント

inputBox(prompt)

ユーザーのブラウザにテキスト入力ボックスを含むダイアログ ボックスをポップアップ表示します。

inputBox メソッドは、指定されたプロンプトをユーザーに表示するクライアントサイドの入力ボックスを表示します。この関数を使用すると、サーバーサイド スクリプトが停止します。ユーザーがダイアログを消去すると自動的に再開されますが、JDBC 接続は停止中も保持されません。

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');
 この方法はおすすめしません。代わりに、UI プロンプトを使用します。

パラメータ

名前型説明
promptStringダイアログ ボックスに表示されるテキスト。

戻る

String - ユーザーが入力したテキスト（キャンセルされたダイアログの場合は「cancel」、閉じられたダイアログの場合は「dismissed」）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(prompt, buttons)

ユーザーのブラウザにテキスト入力ボックスを含むダイアログ ボックスをポップアップ表示します。

inputBox メソッドは、指定されたプロンプトをユーザーに表示し、表示するボタンを選択できるクライアントサイドの入力ボックスを表示します。この関数を使用すると、サーバーサイド スクリプトが停止します。ユーザーがダイアログを消去すると自動的に再開されますが、JDBC 接続は停止中も保持されません。

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
 この方法はおすすめしません。代わりに、UI プロンプトを使用します。

パラメータ

名前型説明
promptStringダイアログ ボックスに表示されるテキスト。
buttonsButtonSet使用するボタンセットのタイプ。

戻る

String - ユーザーが入力したテキスト（キャンセルされたダイアログの場合は「cancel」、閉じられたダイアログの場合は「dismissed」）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(title, prompt, buttons)

ユーザーのブラウザにテキスト入力ボックスを含むダイアログ ボックスをポップアップ表示します。

inputBox メソッドは、指定されたタイトルのクライアントサイド入力ボックスを表示します。このボックスには、指定されたプロンプトがユーザーに表示され、表示するボタンを選択できます。この関数を使用すると、サーバーサイド スクリプトが停止します。ユーザーがダイアログを消去すると自動的に再開されますが、JDBC 接続は一時停止中に保持されません。

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);
 この方法はおすすめしません。代わりに、UI プロンプトを使用します。

パラメータ

名前型説明
titleStringダイアログ ボックスのタイトル。
promptStringダイアログ ボックスに表示されるテキスト。
buttonsButtonSet使用するボタンセットのタイプ。

戻る

String - ユーザーが入力したテキスト（キャンセルされたダイアログの場合は「cancel」、閉じられたダイアログの場合は「dismissed」）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt)

指定されたメッセージと [OK] ボタンを含むダイアログ ボックスがユーザーのブラウザにポップアップ表示されます。

msgBox メソッドは、指定されたメッセージをユーザーに表示するクライアントサイド メッセージ ボックスを表示します。この方法では、サーバーサイド スクリプトが一時停止されます。ユーザーがダイアログを消去すると自動的に再開されますが、JDBC 接続は停止中も保持されません。

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
 この方法はおすすめしません。代わりに、UI アラート ダイアログを使用してください。

パラメータ

名前型説明
promptStringダイアログ ボックスに表示されるテキスト。

戻る

String - ユーザーがクリックしたボタンのテキスト（閉じたダイアログの場合は「キャンセル」）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt, buttons)

指定されたメッセージと指定されたボタンを含むダイアログ ボックスをユーザーのブラウザに表示します。

msgBox メソッドは、指定されたメッセージをユーザーに表示し、表示するボタンの選択肢を提供するクライアントサイド メッセージ ボックスを表示します。この方法では、サーバーサイド スクリプトが一時停止されます。ユーザーがダイアログを消去すると自動的に再開されますが、JDBC 接続は停止中も保持されません。

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
 この方法はおすすめしません。代わりに、UI アラート ダイアログを使用してください。

パラメータ

名前型説明
promptStringダイアログ ボックスに表示されるテキスト。
buttonsButtonSet使用するボタンセットのタイプ。

戻る

String - ユーザーがクリックしたボタンのテキスト（閉じたダイアログの場合は「キャンセル」）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(title, prompt, buttons)

指定されたタイトル、メッセージ、指定されたボタンを含むダイアログ ボックスをユーザーのブラウザにポップアップ表示します。

msgBox メソッドは、指定されたタイトルのクライアントサイド メッセージ ボックスを表示します。このメッセージ ボックスには、指定されたメッセージが表示され、表示するボタンを選択できます。この方法では、サーバーサイド スクリプトが一時停止されることに注意してください。ユーザーがダイアログを消去すると自動的に再開されますが、JDBC 接続は一時停止中に保持されません。

// The code below displays "hello world" in a dialog box with a custom title and
// Yes and No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);
 この方法はおすすめしません。代わりに、UI アラート ダイアログを使用してください。

パラメータ

名前型説明
titleStringダイアログ ボックスのタイトル。
promptStringダイアログ ボックスに表示されるテキスト。
buttonsButtonSet使用するボタンセットのタイプ。

戻る

String - ユーザーがクリックしたボタンのテキスト（閉じたダイアログの場合は「キャンセル」）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets