Class Browser

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。
ブラウザ

このクラスを使用して、Google スプレッドシート固有のダイアログ ボックスにアクセスできます。

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

関連ドキュメント

Properties

プロパティ種類説明
ButtonsButtonSet

Methods

方法戻り値の型概要
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'.
var name = Browser.inputBox('Enter your name');
この方法はおすすめしません。代わりに、UI プロンプトを使用してください。

パラメータ

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

戻る

String - ユーザーが入力したテキスト(またはキャンセルまたは拒否したダイアログの場合は ' キャンセル&#39)。

認可

このメソッドを使用するスクリプトには、次の 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'.
var name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
この方法はおすすめしません。代わりに、UI プロンプトを使用してください。

パラメータ

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

戻る

String - ユーザーが入力したテキスト(またはキャンセルまたは拒否したダイアログの場合は ' キャンセル&#39)。

認可

このメソッドを使用するスクリプトには、次の 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'.
var name = Browser.inputBox('ID Check', 'Enter your name', Browser.Buttons.OK_CANCEL);
この方法はおすすめしません。代わりに、UI プロンプトを使用してください。

パラメータ

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

戻る

String - ユーザーが入力したテキスト(またはキャンセルまたは拒否したダイアログの場合は ' キャンセル&#39)。

認可

このメソッドを使用するスクリプトには、次の 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 - ユーザーがクリックするボタンの小文字テキスト(またはダイアログを閉じる場合は ' キャンセル&#39)。

認可

このメソッドを使用するスクリプトには、次の 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 - ユーザーがクリックするボタンの小文字テキスト(またはダイアログを閉じる場合は ' キャンセル&#39)。

認可

このメソッドを使用するスクリプトには、次の 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 - ユーザーがクリックするボタンの小文字テキスト(またはダイアログを閉じる場合は ' キャンセル&#39)。

認可

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

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