Class HtmlService

HtmlService

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 en un navegador. En su lugar, deben depurar 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 objeto HtmlOutput nuevo 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 objeto HtmlOutput nuevo 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 objeto HtmlTemplate nuevo 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 objeto HtmlOutput nuevo que se puede mostrar desde la secuencia de comandos.

var output = HtmlService.createHtmlOutput();

Devolvedor

HtmlOutput: 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 para obtener HTML

Devolvedor

HtmlOutput: Es el nuevo objeto HtmlOutput.

Arroja

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


createHtmlOutput(html)

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

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

Parámetros

NombreTipoDescripción
htmlStringel contenido que entregará

Devolvedor

HtmlOutput: El nuevo objeto HtmlOutput

Arroja

Error: Si el HTML tiene un formato 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á

Devolvedor

HtmlOutput: Es el nuevo objeto HtmlOutput.

Arroja

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


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 obtiene HTML.

Devolvedor

HtmlTemplate: Es 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.

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

Parámetros

NombreTipoDescripción
htmlStringel contenido de la plantilla

Devolvedor

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á

Devolvedor

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 app web.

Devolvedor

String: Es la string usuario-agente.