Class HtmlService

HtmlService

Es un 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 en un navegador. En su lugar, deben limpiar el código HTML para que no pueda realizar acciones maliciosas. Consulta la descripción de HtmlOutput para conocer las limitaciones que esto implica en lo que se puede mostrar.

Propiedades

PropiedadTipoDescripción
SandboxModeSandboxModeEs una enumeración que representa los modos de zona de pruebas que se pueden usar para las secuencias de comandos HtmlService del cliente.
XFrameOptionsModeXFrameOptionsModeEs una enumeración que representa los modos X-Frame-Options que se pueden usar para las secuencias de comandos HtmlService del cliente.

Métodos

MétodoTipo de datos que se muestraDescripción breve
createHtmlOutput()HtmlOutputCrea un nuevo objeto HtmlOutput que se puede mostrar desde la secuencia de comandos.
createHtmlOutput(blob)HtmlOutputCrea un objeto HtmlOutput nuevo a partir de un recurso BlobSource.
createHtmlOutput(html)HtmlOutputCrea un nuevo objeto HtmlOutput que se puede mostrar desde la secuencia de comandos.
createHtmlOutputFromFile(filename)HtmlOutputCrea un nuevo objeto HtmlOutput a partir de un archivo en el editor de código.
createTemplate(blob)HtmlTemplateCrea un objeto HtmlTemplate nuevo a partir de un recurso BlobSource.
createTemplate(html)HtmlTemplateCrea un nuevo objeto HtmlTemplate que se puede mostrar desde la secuencia de comandos.
createTemplateFromFile(filename)HtmlTemplateCrea un nuevo objeto HtmlTemplate a partir de un archivo en el editor de código.
getUserAgent()StringObtiene la cadena de usuario-agente del navegador actual.

Documentación detallada

createHtmlOutput()

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

const output = HtmlService.createHtmlOutput();

Volver

HtmlOutput: Es 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

NombreTipoDescripción
blobBlobSourceel objeto del que se extraerá el código HTML

Volver

HtmlOutput: Es el nuevo objeto HtmlOutput.

Arroja

Error: Si el BLOB no contiene HTML o si el HTML tiene un formato incorrecto

createHtmlOutput(html)

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

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

Parámetros

NombreTipoDescripción
htmlStringel contenido que se publicará

Volver

HtmlOutput: Es el nuevo objeto HtmlOutput.

Arroja

Error: Si el código HTML tiene un formato incorrecto

createHtmlOutputFromFile(filename)

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

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

Parámetros

NombreTipoDescripción
filenameStringel nombre del archivo que se usará

Volver

HtmlOutput: Es el nuevo objeto HtmlOutput.

Arroja

Error: Si no se encontró el archivo o si el código HTML tiene un formato incorrecto

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

NombreTipoDescripción
blobBlobSourceEs el objeto del que se extraerá el código HTML.

Volver

HtmlTemplate: Es el nuevo objeto HtmlTemplate.

Arroja

Error: Si el BLOB no contiene HTML

createTemplate(html)

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

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

Parámetros

NombreTipoDescripción
htmlStringel contenido de la plantilla

Volver

HtmlTemplate: Es el nuevo objeto HtmlTemplate.

createTemplateFromFile(filename)

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

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

Parámetros

NombreTipoDescripción
filenameStringel nombre del archivo que se usará

Volver

HtmlTemplate: Es el nuevo objeto HtmlTemplate.

Arroja

Error: Si no se encontró el archivo

getUserAgent()

Obtiene la cadena de usuario-agente del 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