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
Propiedad | Tipo | Descripción |
---|---|---|
SandboxMode | SandboxMode | Una enumeración que representa los modos de la zona de pruebas que se pueden usar para las secuencias de comandos HtmlService del cliente |
XFrameOptionsMode | XFrameOptionsMode | 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 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 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
Nombre | Tipo | Descripción |
---|---|---|
blob | BlobSource | el 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
Nombre | Tipo | Descripción |
---|---|---|
html | String | el 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
Nombre | Tipo | Descripción |
---|---|---|
filename | String | el 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
Nombre | Tipo | Descripción |
---|---|---|
blob | BlobSource | El 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 <?= new Date() ?></b>');
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
html | String | el 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
Nombre | Tipo | Descripción |
---|---|---|
filename | String | el 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.