Se usó la API de Cloud Translation para traducir esta página.

Class 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

Propiedad	Tipo	Descripción
`SandboxMode`	`SandboxMode`	Es una enumeración que representa los modos de zona de pruebas que se pueden usar para las secuencias de comandos `HtmlService` del cliente.
`XFrameOptionsMode`	`XFrameOptionsMode`	Es 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étodo	Tipo de datos que se muestra	Descripción breve
`createHtmlOutput()`	`HtmlOutput`	Crea un nuevo objeto `HtmlOutput` 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 nuevo objeto `HtmlOutput` que se puede mostrar desde la secuencia de comandos.
`createHtmlOutputFromFile(filename)`	`HtmlOutput`	Crea un nuevo objeto `HtmlOutput` 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 nuevo objeto `HtmlTemplate` que se puede mostrar desde la secuencia de comandos.
`createTemplateFromFile(filename)`	`HtmlTemplate`	Crea un nuevo objeto `HtmlTemplate` a partir de un archivo en el editor de código.
`getUserAgent()`	`String`	Obtiene 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

Nombre	Tipo	Descripción
`blob`	`BlobSource`	el 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

Nombre	Tipo	Descripción
`html`	`String`	el 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

Nombre	Tipo	Descripción
`filename`	`String`	el 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

Nombre	Tipo	Descripción
`blob`	`BlobSource`	Es 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

Nombre	Tipo	Descripción
`html`	`String`	el 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

Nombre	Tipo	Descripción
`filename`	`String`	el 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