Class HtmlOutput

Agrega una metaetiqueta a la página. Las metaetiquetas incluidas directamente en un archivo HTML de Apps Script se ignoran. Solo se permiten las siguientes etiquetas meta:

<meta name="apple-mobile-web-app-capable" cont>e<nt="..."/
meta name="google-site-ver>i<fication" content="..."/
meta name>=<"mobile-web-app-capable" >content="..."/
meta name="viewport" content="..."/

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

Parámetros

Volver

HtmlOutput: Es el resultado para el encadenamiento.

Agrega contenido nuevo al contenido de este HtmlOutput. Úsalo solo para el contenido de una fuente confiable, ya que no se escapa.

// Log &<q>uot;bHello, w<or><l>d!/bpHello again, w<or>ld./p"
const output = HtmlService.createHt<m>lOutput('<bH>ello, world!/b'<)>;
output.append(<9;>pHello again, world./p');
Logger.log(output.getContent());

Parámetros

Volver

HtmlOutput: Es el resultado para el encadenamiento.

Arroja

Error: Si el HTML tiene un formato incorrecto

Consulta también

• appendUntrusted(addedContent)

Agrega contenido nuevo al contenido de este HtmlOutput, con escape contextual.

Este método escapa correctamente el contenido según el estado actual de HtmlOutput, de modo que el resultado es una cadena segura sin marcas ni efectos secundarios. Usa este método en lugar de append siempre que agregues contenido de una fuente no confiable, como un usuario, para evitar permitir accidentalmente un error de secuencia de comandos entre sitios (XSS) en el que el contenido o el lenguaje de marcado que agregues provoquen una ejecución de código inesperada.

// Log &<q>uot;bHello, w<or>&ld!/&blt;pgt;Hello again, w&orld.&lt;/pgt;"
const output = HtmlService.createHt<m>lOutput('<bH>ello, world!/b');
output<.>appendUntrusted(<9;>pHello again, world./p');
Logger.log(output.getContent());

Parámetros

Volver

HtmlOutput: Es el resultado para el encadenamiento.

Arroja

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

Consulta también

• append(addedContent)

Devuelve un HtmlTemplate respaldado por este HtmlOutput. Este método se puede usar para crear una plantilla de forma incremental. Los cambios futuros en HtmlOutput también afectan el contenido de HtmlTemplate.

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
const template = output.asTemplate();

Volver

HtmlTemplate: El nuevo HtmlTemplate.

Borra el contenido actual.

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
output.clear();

Volver

HtmlOutput: Es el resultado para el encadenamiento.

Devuelve los datos dentro de este objeto como un blob convertido al tipo de contenido especificado. Este método agrega la extensión adecuada al nombre del archivo, por ejemplo, "miarchivo.pdf". Sin embargo, supone que la parte del nombre de archivo que sigue al último punto (si hay alguno) es una extensión existente que se debe reemplazar. Por lo tanto, "ShoppingList.12.25.2014" se convierte en "ShoppingList.12.25.pdf".

Para ver las cuotas diarias de conversiones, consulta Cuotas para los servicios de Google. Es posible que los dominios de Google Workspace recién creados estén sujetos temporalmente a cuotas más estrictas.

Parámetros

Volver

Blob: Son los datos como un BLOB.

Devuelve los datos dentro de este objeto como un blob.

Volver

Blob: Son los datos como un BLOB.

Obtiene el contenido de este HtmlOutput.

// Log &<q>uot;bHello, w<or>ld!/b"
const output = HtmlService.createHt<m>lOutput('<bH>ello, world!/b');
Logger.log(output.getContent());

Volver

String: Es el contenido que se entrega.

Obtiene la URL de una etiqueta de vínculo de favicon agregada a la página llamando a setFaviconUrl(iconUrl). Se ignoran las etiquetas de vínculo de ícono de página incluidas directamente en un archivo HTML de Apps Script.

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
output.setFaviconUrl('http://www.example.com/image.png');
Logger.log(output.getFaviconUrl());

Volver

String: Es la URL de la imagen del favicon.

Obtiene la altura inicial del diálogo personalizado en Documentos, Hojas de cálculo o Formularios de Google. Si el HtmlOutput se publica como una app web, este método devuelve null. Para cambiar el tamaño de un diálogo que ya está abierto, llama a google.script.host.setHeight(height) en el código del cliente.

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
output.setHeight(200);
Logger.log(output.getHeight());

Volver

Integer: La altura en píxeles.

Obtiene un array de objetos que representan las metaetiquetas agregadas a la página llamando a addMetaTag(name, content). Las metaetiquetas incluidas directamente en un archivo HTML de Apps Script se ignoran.

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

const tags = output.getMetaT<ags();
Logger.log(
    '>meta name="%s" content="%s"/',
    tags[0].getName(),
    tags[0].getContent(),
);

Volver

HtmlOutputMetaTag[]: Es un array de objetos que representan las metaetiquetas agregadas a la página llamando a addMetaTag(name, content).

Obtiene el título de la página de salida. Ten en cuenta que se ignora el elemento HTML <title>.

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
Logger.log(output.getTitle());

Volver

String: Es el título de la página.

Obtiene el ancho inicial del diálogo personalizado en Documentos, Hojas de cálculo o Formularios de Google. Si el HtmlOutput se publica como una app web, este método devuelve null. Para cambiar el tamaño de un diálogo que ya está abierto, llama a google.script.host.setWidth(width) en el código del cliente.

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
output.setWidth(200);
Logger.log(output.getWidth());

Volver

Integer: Es el ancho en píxeles.

Establece el contenido de este HtmlOutput.

const output = HtmlService.createHtmlOutput();
output.setContent(&<#>39;bHello, wo<rl>d!/b');

Parámetros

Volver

HtmlOutput: Es el resultado para el encadenamiento.

Arroja

Error: Si el HTML tiene un formato incorrecto

Agrega una etiqueta de vínculo para un favicon a la página. Se ignoran las etiquetas de vínculo de favicon incluidas directamente en un archivo HTML de Apps Script.

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
output.setFaviconUrl('http://www.example.com/image.png');

Parámetros

Volver

HtmlOutput: Es el resultado para el encadenamiento.

Establece la altura inicial del diálogo personalizado en Documentos, Hojas de cálculo o Formularios de Google. Si el HtmlOutput se publica como una app web, este método no tiene efecto. Para cambiar el tamaño de un diálogo que ya está abierto, llama a google.script.host.setHeight(height) en el código del cliente.

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
output.setHeight(200);

Parámetros

Volver

HtmlOutput: Es el resultado para el encadenamiento.

Este método ya no tiene efecto. Antes, establecía el objeto sandbox mode que se usaba para las secuencias de comandos del cliente. Para proteger a los usuarios de que se les proporcione HTML o JavaScript maliciosos, el código del cliente que se proporciona desde el servicio HTML se ejecuta en una zona de pruebas de seguridad que impone restricciones al código. Originalmente, este método permitía a los autores de secuencias de comandos elegir entre diferentes versiones del entorno de pruebas, pero ahora todas las secuencias de comandos usan el modo IFRAME, independientemente del modo de entorno de pruebas que se haya establecido. Para obtener más información, consulta la guía sobre las restricciones en el servicio HTML.

El modo IFRAME impone muchas menos restricciones que los otros modos de zona de pruebas y se ejecuta más rápido, pero no funciona en absoluto en algunos navegadores más antiguos, como Internet Explorer 9. El modo de zona de pruebas se puede leer en una secuencia de comandos del cliente inspeccionando google.script.sandbox.mode. Ten en cuenta que esta propiedad devuelve el modo real en el cliente, que puede diferir del modo solicitado en el servidor si el modo solicitado no es compatible con el navegador del usuario.

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>

Parámetros

Volver

HtmlOutput: Es el resultado para el encadenamiento.

Establece el título de la página de salida. En el caso de las apps web, este es el título de toda la página, mientras que, en el caso de HtmlOutput que se muestra en Hojas de cálculo de Google, este es el título del diálogo.

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
output.setTitle('My First Page');

Parámetros

Volver

HtmlOutput: Es el resultado para el encadenamiento.

Establece el ancho inicial de un diálogo personalizado en Documentos, Hojas de cálculo o Formularios de Google. Si el HtmlOutput se publica como una app web, este método no tiene efecto. Para cambiar el tamaño de un diálogo que ya está abierto, llama a google.script.host.setWidth(width) en el código del cliente.

const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
output.setWidth(200);

Parámetros

Volver

HtmlOutput: Es el resultado para el encadenamiento.

Establece el estado del encabezado X-Frame-Options de la página, que controla la prevención del clickjacking.

Si se configura XFrameOptionsMode.ALLOWALL, cualquier sitio puede incluir la página en un iframe, por lo que el desarrollador debe implementar su propia protección contra el clickjacking.

Si una secuencia de comandos no establece un modo X-Frame-Options, Apps Script usa el modo XFrameOptionsMode.DEFAULT de forma predeterminada.

// Serve HTML with no X-Frame-Options header (in Apps Script server-side code).
const output = HtmlService.createHtmlOutput(&<#>39;bHello, wo<rl>d!/b');
output.setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);

Parámetros

Volver

HtmlOutput: Es el resultado para el encadenamiento.