Класс google.script.host (клиентский API)

google.script.host — это асинхронный клиентский API JavaScript, который может взаимодействовать с диалоговыми окнами или боковыми панелями в Документах, Таблицах или Формах Google, содержащих страницы служб HTML . Чтобы выполнить функции на стороне сервера из кода на стороне клиента, используйте google.script.run . Дополнительные сведения см. в руководстве по взаимодействию с серверными функциями в службе HTML.

Характеристики

Свойство	Описание
origin	Предоставляет домен хоста, чтобы сценарии могли правильно установить свое происхождение.

Методы

Метод	Тип возврата	Краткое описание
close()	void	Закрывает текущий диалог или боковую панель.
editor.focus()	void	Переключает фокус браузера с диалогового окна или боковой панели на редактор Google Docs, Sheets или Forms.
setHeight(height)	void	Устанавливает высоту текущего диалога.
setWidth(width)	void	Устанавливает ширину текущего диалога.

Подробная документация

close()

Закрывает текущий диалог или боковую панель.

Код.gs

function onOpen(e) {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
      .createMenu('Sidebar').addItem('Show', 'showSidebar').addToUi();
}

function showSidebar() {
  var html = HtmlService.createHtmlOutputFromFile('Index');
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
      .showSidebar(html);
}

Индекс.html

<input type="button" value="Close"
  onclick="google.script.host.close()" />

---

editor.focus()

Переключает фокус браузера с диалогового окна или боковой панели на редактор Google Docs, Sheets или Forms.

Код.gs

function onOpen(e) {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
      .createMenu('Sidebar').addItem('Show', 'showSidebar').addToUi();
}

function showSidebar() {
  var html = HtmlService.createHtmlOutputFromFile('Index');
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
      .showSidebar(html);
}

Индекс.html

<input type="button" value="Switch focus"
  onclick="google.script.host.editor.focus()" />

---

setHeight(height)

Устанавливает высоту текущего диалога.

Код.gs

function onOpen(e) {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
      .createMenu('Dialog').addItem('Show', 'showDialog').addToUi();
}

function showDialog() {
  var html = HtmlService.createHtmlOutputFromFile('Index')
      .setWidth(300)
      .setHeight(200);
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
      .showModalDialog(html, 'Dialog title');
}

Индекс.html

<script>
  function resizeDialog(width, height) {
    google.script.host.setWidth(width);
    google.script.host.setHeight(height);
  }
</script>
<input type="button" value="Resize dialog"
  onclick="resizeDialog(450, 300)" />

Параметры

Имя	Тип	Описание
height	Integer	новая высота в пикселях

---

setWidth(width)

Устанавливает ширину текущего диалога.

Код.gs

function onOpen(e) {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
      .createMenu('Dialog').addItem('Show', 'showDialog').addToUi();
}

function showDialog() {
  var html = HtmlService.createHtmlOutputFromFile('Index')
      .setWidth(300)
      .setHeight(200);
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
      .showModalDialog(html, 'Dialog title');
}

Индекс.html

<script>
  function resizeDialog(width, height) {
    google.script.host.setWidth(width);
    google.script.host.setHeight(height);
  }
</script>
<input type="button" value="Resize dialog"
  onclick="resizeDialog(450, 300)" />

Параметры

Имя	Тип	Описание
width	Integer	новая ширина в пикселях