Class Ui

Abre uma caixa de diálogo no editor do usuário com a mensagem fornecida e um "OK" . Esse método suspende o script do lado do servidor enquanto a caixa de diálogo está aberta. O script é retomado depois que o usuário dispensa a caixa de diálogo, mas Jdbc conexões e LockService bloqueios não persistem durante a suspensão. Para mais informações, consulte o guia sobre caixas de diálogo e barras laterais.

// Display "Hello, world" in a dialog box with an "OK" button. The user can also close the
// dialog by clicking the close button in its title bar.
SpreadsheetApp.getUi().alert('Hello, world');

Parâmetros

Retornar

Button: o botão em que o usuário clicou.

Abre uma caixa de diálogo no editor do usuário com a mensagem e o conjunto de botões fornecidos. Esse método suspende o script do lado do servidor enquanto a caixa de diálogo está aberta. O script é retomado depois que o usuário dispensa a caixa de diálogo, mas Jdbc e LockService fechaduras não persistem durante a suspensão. Para mais informações, consulte o guia sobre caixas de diálogo e barras laterais.

// Display a dialog box with a message and "Yes" and "No" buttons. The user can also close the
// dialog by clicking the close button in its title bar.
var ui = SpreadsheetApp.getUi();
var response = ui.alert('Are you sure you want to continue?', ui.ButtonSet.YES_NO);

// Process the user's response.
if (response == ui.Button.YES) {
  Logger.log('The user clicked "Yes."');
} else {
  Logger.log('The user clicked "No" or the close button in the dialog\'s title bar.');
}

Parâmetros

Retornar

Button: o botão em que o usuário clicou.

Abre uma caixa de diálogo no editor do usuário com o título, a mensagem e o conjunto de botões fornecidos. Isso suspende o script do lado do servidor enquanto a caixa de diálogo está aberta. O script é retomado após o o usuário dispensa a caixa de diálogo, mas Jdbc conexões e LockService bloqueios não persistem durante a suspensão. Para mais informações, consulte o guia sobre caixas de diálogo e barras laterais.

// Display a dialog box with a title, message, and "Yes" and "No" buttons. The user can also
// close the dialog by clicking the close button in its title bar.
var ui = SpreadsheetApp.getUi();
var response = ui.alert('Confirm', 'Are you sure you want to continue?', ui.ButtonSet.YES_NO);

// Process the user's response.
if (response == ui.Button.YES) {
  Logger.log('The user clicked "Yes."');
} else {
  Logger.log('The user clicked "No" or the close button in the dialog\'s title bar.');
}

Parâmetros

Retornar

Button: o botão em que o usuário clicou.

Cria um builder que pode ser usado para inserir um submenu no menu "Extensões" do editor. A menu não é atualizado até que Menu.addToUi() seja chamado. Se o script estiver em execução como um complemento, o nome do submenu corresponde ao nome do complemento na loja on-line; se o script estiver vinculado ao documento diretamente, o nome do submenu, corresponde ao nome do script. Para mais informações, consulte o guia de menus.

// Add an item to the Add-on menu, under a sub-menu whose name is set automatically.
function onOpen(e) {
  SpreadsheetApp.getUi()
      .createAddonMenu()
      .addItem('Show', 'showSidebar')
      .addToUi();
}

Retornar

Menu: o novo criador de menus.

Cria um builder que pode ser usado para adicionar um menu à interface do usuário do editor. O menu não está ser adicionado até que Menu.addToUi() seja chamado. Para mais informações, consulte o guia de menus. O rótulo para um menu de nível superior deve ser no título (todas as principais palavras em maiúscula), embora o rótulo de um submenu deva estar (somente a primeira palavra em maiúscula). Se o script for publicado como um complemento, o parâmetro caption será ignorado, e a é adicionado como um submenu do menu "Extensões", equivalente a createAddonMenu().

// Add a custom menu to the active document, including a separator and a sub-menu.
function onOpen(e) {
  SpreadsheetApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(SpreadsheetApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

Parâmetros

Retornar

Menu: o novo criador de menus.

Abre uma caixa de diálogo de entrada no editor do usuário com a mensagem especificada e um "OK" . Isso suspende o script do lado do servidor enquanto a caixa de diálogo está aberta. O script é retomado após o o usuário dispensa a caixa de diálogo, mas Jdbc conexões e LockService bloqueios não persistem durante a suspensão. Para mais informações, consulte o guia sobre caixas de diálogo e barras laterais.

// Display a dialog box with a message, input field, and an "OK" button. The user can also
// close the dialog by clicking the close button in its title bar.
var ui = SpreadsheetApp.getUi();
var response = ui.prompt('Enter your name:');

// Process the user's response.
if (response.getSelectedButton() == ui.Button.OK) {
  Logger.log('The user\'s name is %s.', response.getResponseText());
} else {
  Logger.log('The user clicked the close button in the dialog\'s title bar.');
}

Parâmetros

Retornar

PromptResponse: uma representação da resposta do usuário.

Abre uma caixa de diálogo de entrada no editor do usuário com a mensagem e o conjunto de botões especificados. Isso suspende o script do lado do servidor enquanto a caixa de diálogo está aberta. O script é retomado após o o usuário dispensa a caixa de diálogo, mas Jdbc e LockService fechaduras não persistem durante a suspensão. Para mais informações, consulte o guia sobre caixas de diálogo e barras laterais.

// Display a dialog box with a message, input field, and "Yes" and "No" buttons. The user can
// also close the dialog by clicking the close button in its title bar.
var ui = SpreadsheetApp.getUi();
var response = ui.prompt('May I know your name?', ui.ButtonSet.YES_NO);

// Process the user's response.
if (response.getSelectedButton() == ui.Button.YES) {
  Logger.log('The user\'s name is %s.', response.getResponseText());
} else if (response.getSelectedButton() == ui.Button.NO) {
  Logger.log('The user didn\'t want to provide a name.');
} else {
  Logger.log('The user clicked the close button in the dialog\'s title bar.');
}

Parâmetros

Retornar

PromptResponse: uma representação da resposta do usuário.

Abre uma caixa de diálogo de entrada no editor do usuário com o título, a mensagem e o conjunto de botões. Esse método suspende o script do lado do servidor enquanto a caixa de diálogo está aberta. O script é retomado depois que o usuário dispensa a caixa de diálogo, mas as conexões Jdbc e os bloqueios LockService não persistem na suspensão. Para mais informações, consulte o guia para caixas de diálogo e barras laterais.

// Display a dialog box with a title, message, input field, and "Yes" and "No" buttons. The
// user can also close the dialog by clicking the close button in its title bar.
var ui = SpreadsheetApp.getUi();
var response = ui.prompt('Getting to know you', 'May I know your name?', ui.ButtonSet.YES_NO);

// Process the user's response.
if (response.getSelectedButton() == ui.Button.YES) {
  Logger.log('The user\'s name is %s.', response.getResponseText());
} else if (response.getSelectedButton() == ui.Button.NO) {
  Logger.log('The user didn\'t want to provide a name.');
} else {
  Logger.log('The user clicked the close button in the dialog\'s title bar.');
}

Parâmetros

Retornar

PromptResponse: uma representação da resposta do usuário.

Abre uma caixa de diálogo modal no editor do usuário com conteúdo personalizado do lado do cliente. Esse método não não suspender o script do lado do servidor enquanto a caixa de diálogo estiver aberta; Para se comunicar com o script do lado do servidor, o componente do lado do cliente precisa fazer callbacks assíncronos usando a API google.script para HtmlService. Fechar a caixa de diálogo chame de forma programática google.script.host.close() no lado do cliente de um HtmlService da Web app. Para mais informações, consulte o guia sobre caixas de diálogo e barras laterais.

As caixas de diálogo modais impedem que o usuário interaja com qualquer coisa além da caixa de diálogo. De as caixas de diálogo sem modo e as barras laterais permitem que o usuário interaja com o editor. Em quase todos os casos, uma caixa de diálogo modal ou barra lateral é uma opção melhor do que uma caixa de diálogo sem modo.

// Display a modal dialog box with custom HtmlService content.
var htmlOutput = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setWidth(250)
    .setHeight(300);
SpreadsheetApp.getUi().showModalDialog(htmlOutput, 'My add-on');

Parâmetros

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/script.container.ui

Abre uma caixa de diálogo sem modo no editor do usuário com conteúdo personalizado do lado do cliente. Esse método não suspende o script do lado do servidor enquanto a caixa de diálogo está aberta. Para se comunicar com o script do lado do servidor, o componente do lado do cliente precisa fazer callbacks assíncronos usando a API google.script para HtmlService. Fechar a caixa de diálogo chame de forma programática google.script.host.close() no lado do cliente de um HtmlService da Web app. Para mais informações, consulte o guia sobre caixas de diálogo e barras laterais.

As caixas de diálogo sem modo permitem que o usuário interaja com o editor atrás da caixa de diálogo. Por outro lado, caixas de diálogo modais não têm. Em quase todos os casos, um modal ou sidebar é uma opção melhor do que uma caixa de diálogo sem modo.

// Display a modeless dialog box with custom HtmlService content.
var htmlOutput = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setWidth(250)
    .setHeight(300);
SpreadsheetApp.getUi().showModelessDialog(htmlOutput, 'My add-on');

Parâmetros

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/script.container.ui

Abre uma barra lateral no editor do usuário com conteúdo personalizado do lado do cliente. Esse método não não suspender o script do lado do servidor enquanto a barra lateral estiver aberta; Para se comunicar com o script do lado do servidor, o componente do lado do cliente precisa fazer callbacks assíncronos usando a API google.script para HtmlService. Para fechar a barra lateral chame de forma programática google.script.host.close() no lado do cliente de um HtmlService da Web app. Para mais informações, consulte o guia sobre caixas de diálogo e barras laterais.

A barra lateral é exibida no lado direito do editor para usuários cujos ambientes usam uma idiomas escritos da esquerda para a direita e à esquerda do editor para idiomas escritos da direita para a esquerda. Todos barras laterais mostradas por scripts têm 300 pixels de largura.

// Display a sidebar with custom HtmlService content.
var htmlOutput = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setTitle('My add-on');
SpreadsheetApp.getUi().showSidebar(htmlOutput);

Parâmetros

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/script.container.ui