Clase google.script.host (API del cliente)

google.script.host es una API de JavaScript asíncrona del cliente que puede interactuar. con cuadros de diálogo o barras laterales en Documentos, Hojas de cálculo o Formularios de Google que contengan páginas de servicio HTML. Para ejecutar funciones del servidor desde el código del cliente, usa google.script.run. Para obtener más información, consulta el guía para la comunicación con las funciones del servidor en el servicio HTML.

Propiedades

Propiedad	Descripción
origin	Proporciona el dominio del host, de modo que las secuencias de comandos puedan establecer su el origen correctamente.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
close()	void	Cierra el diálogo o la barra lateral actuales.
editor.focus()	void	Cambia el enfoque del navegador del diálogo o la barra lateral al editor de Documentos, Hojas de cálculo o Formularios de Google.
setHeight(height)	void	Establece la altura del diálogo actual.
setWidth(width)	void	Establece el ancho del diálogo actual.

Documentación detallada

close()

Cierra el diálogo o la barra lateral actuales.

Code.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);
}

Index.html

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

---

editor.focus()

Cambia el enfoque del navegador del diálogo o la barra lateral al editor de Documentos, Hojas de cálculo o Formularios de Google.

Code.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);
}

Index.html

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

---

setHeight(height)

Establece la altura del diálogo actual.

Code.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');
}

Index.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)" />

Parámetros

Nombre	Tipo	Descripción
height	Integer	la altura nueva en píxeles

---

setWidth(width)

Establece el ancho del diálogo actual.

Code.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');
}

Index.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)" />

Parámetros

Nombre	Tipo	Descripción
width	Integer	el nuevo ancho en píxeles