Prompt dialogs

Prompt dialogs are a type of dialog box in Apps Script that allows you to prompt users for input. This input can then be used in your script to perform certain actions. Prompt dialogs can be useful in a variety of scenarios, such as when you need to ask users to input specific values or when you want to confirm an action before proceeding.

To create a prompt dialog, you can use the ui.prompt() method in your Apps Script code. Here’s an example:

function myFunction() {
  var response = ui.prompt('Please enter your name:', ui.ButtonSet.OK_CANCEL);

  if (response.getSelectedButton() == ui.Button.OK) {
    var name = response.getResponseText();
    Logger.log('Hello, ' + name + '!');
  } else {
    Logger.log('User cancelled prompt.');

In this example, the ui.prompt() method creates a dialog box that prompts the user to enter their name. The second argument (ui.ButtonSet.OK_CANCEL) specifies that the dialog should have “OK” and “Cancel” buttons.

The response.getSelectedButton() method checks which button the user clicked. If they clicked “OK”, then the getResponseText() method retrieves the text that the user entered. This text is then logged to the console using the Logger.log() method. If the user clicked “Cancel”, then the script logs a message indicating that the prompt was cancelled.

Prompt dialogs can be customized to include different button sets, default values, and more. They can be a useful tool for interacting with users and collecting input in your Apps Script projects.