Class HtmlService

Servicio HTML

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

Debido a consideraciones de seguridad, las secuencias de comandos no pueden mostrar contenido directamente a un navegador. En su lugar, deben limpiar 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

PropiedadTipoDescripción
SandboxModeSandboxModeUna enumeración que representa los modos de la zona de pruebas que se pueden usar para las secuencias de comandos HtmlService del cliente
XFrameOptionsModeXFrameOptionsModeUna 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 objeto HtmlOutput nuevo 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 objeto HtmlTemplate nuevo a partir de un archivo en el editor de código.
getUserAgent()StringObtiene la string usuario-agente para el navegador actual.

Documentación detallada

createHtmlOutput()

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

var 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) {
  var output = HtmlService.createHtmlOutput(blob);
  return output;
}

Parámetros

NombreTipoDescripción
blobBlobSourceel objeto del que se extraiga el HTML

Volver

HtmlOutput: Es el nuevo objeto HtmlOutput.

Arroja

Error: Si el BLOB no contiene HTML o el formato es incorrecto


createHtmlOutput(html)

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

var 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: El formato HTML es incorrecto


createHtmlOutputFromFile(filename)

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

var 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 el HTML que contiene no tiene el formato correcto.


createTemplate(blob)

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

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

Parámetros

NombreTipoDescripción
blobBlobSourceEl objeto del que se quitará 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.

var 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 objeto HtmlTemplate nuevo a partir de un archivo en el editor de código.

var 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 string usuario-agente para el navegador actual. Muestra null para la mayoría de las ejecuciones de secuencias de comandos si no se usan en la función doGet() o doPost() de una aplicación web.

Volver

String: la string usuario-agente