Class HtmlService

HtmlService

Servicio para mostrar HTML y otro contenido de texto desde una secuencia de comandos.

Debido a consideraciones de seguridad, las secuencias de comandos no pueden mostrar contenido directamente a un navegador. En cambio, deben desinfectar el HTML para que no pueda realizar acciones maliciosas. Consulta la descripción de HtmlOutput para conocer las limitaciones que esto implica sobre lo que se puede mostrar.

Propiedades

Propiedad	Tipo	Descripción
SandboxMode	SandboxMode	Es una enumeración que representa los modos de entorno de pruebas que se pueden usar para las secuencias de comandos HtmlService del lado del cliente.
XFrameOptionsMode	XFrameOptionsMode	Es una enumeración que representa los X-Frame-Options modos que se pueden usar para las secuencias de comandos HtmlService del lado del cliente.

Métodos

Método	Tipo de datos que se devuelve	Descripción breve
createHtmlOutput()	HtmlOutput	Crea un objeto HtmlOutput nuevo que se puede mostrar desde la secuencia de comandos.
createHtmlOutput(blob)	HtmlOutput	Crea un objeto HtmlOutput nuevo a partir de un recurso BlobSource.
createHtmlOutput(html)	HtmlOutput	Crea un objeto HtmlOutput nuevo que se puede mostrar desde la secuencia de comandos.
createHtmlOutputFromFile(filename)	HtmlOutput	Crea un objeto HtmlOutput nuevo a partir de un archivo en el editor de código.
createTemplate(blob)	HtmlTemplate	Crea un objeto HtmlTemplate nuevo a partir de un recurso BlobSource.
createTemplate(html)	HtmlTemplate	Crea un objeto HtmlTemplate nuevo que se puede mostrar desde la secuencia de comandos.
createTemplateFromFile(filename)	HtmlTemplate	Crea un objeto HtmlTemplate nuevo a partir de un archivo en el editor de código.
getUserAgent()	String	Obtiene la cadena de usuario-agente para el navegador actual.

Documentación detallada

createHtmlOutput()

Crea un objeto HtmlOutput nuevo que se puede mostrar desde la secuencia de comandos.

const output = HtmlService.createHtmlOutput();

Volver

HtmlOutput : el nuevo objeto HtmlOutput

---

createHtmlOutput(blob)

Crea un objeto HtmlOutput nuevo a partir de un recurso BlobSource.

function createFromBlob(blob) {
  const output = HtmlService.createHtmlOutput(blob);
  return output;
}

Parámetros

Nombre	Tipo	Descripción
blob	BlobSource	Es el objeto del que se obtendrá el HTML.

Volver

HtmlOutput : el nuevo objeto HtmlOutput

Arroja

Error : si el BLOB no contiene HTML o si el HTML está mal formado

---

createHtmlOutput(html)

Crea un objeto HtmlOutput nuevo que se puede mostrar desde la secuencia de comandos.

const output = HtmlService.createHtmlOutput('<b>Hello world!</b>');

Parámetros

Nombre	Tipo	Descripción
html	String	Es el contenido que se publicará.

Volver

HtmlOutput : el nuevo objeto HtmlOutput

Arroja

Error : si el HTML está mal formado

---

createHtmlOutputFromFile(filename)

Crea un objeto HtmlOutput nuevo a partir de un archivo en el editor de código.

const output = HtmlService.createHtmlOutputFromFile('myPage');

Parámetros

Nombre	Tipo	Descripción
filename	String	Es el nombre del archivo que se usará.

Volver

HtmlOutput : el nuevo objeto HtmlOutput

Arroja

Error : si no se encontró el archivo o si el HTML que contiene está mal formado

---

createTemplate(blob)

Crea un objeto HtmlTemplate nuevo a partir de un recurso BlobSource.

function createFromBlob(blob) {
  const template = HtmlService.createTemplate(blob);
  const output = template.evaluate();
  return output;
}

Parámetros

Nombre	Tipo	Descripción
blob	BlobSource	Es el objeto del que se obtendrá el HTML.

Volver

HtmlTemplate : el nuevo objeto HtmlTemplate

Arroja

Error : si el BLOB no contiene HTML

---

createTemplate(html)

Crea un objeto HtmlTemplate nuevo que se puede mostrar desde la secuencia de comandos.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);

Parámetros

Nombre	Tipo	Descripción
html	String	Es el contenido de la plantilla.

Volver

HtmlTemplate : el nuevo objeto HtmlTemplate

---

createTemplateFromFile(filename)

Crea un objeto HtmlTemplate nuevo a partir de un archivo en el editor de código.

const template = HtmlService.createTemplateFromFile('myTemplate');

Parámetros

Nombre	Tipo	Descripción
filename	String	Es el nombre del archivo que se usará.

Volver

HtmlTemplate : el nuevo objeto HtmlTemplate

Arroja

Error : si no se encontró el archivo

---

getUserAgent()

Obtiene la cadena de usuario-agente para el navegador actual. Muestra null para la mayoría de las ejecuciones de secuencias de comandos si no se usa en la función doGet() o doPost() de una app web.

Volver

String : la cadena de usuario-agente