HTML Service

HTML

Esse serviço permite que aplicativos do Apps Script retornem HTML, geralmente como uma interface do usuário. Se você não está começando a usar essa classe, recomendamos que consulte também o guia do Serviço de HTML.

.

Aulas

NomeBreve descrição
HtmlOutputUm objeto HtmlOutput que pode ser disponibilizado a partir de um script.
HtmlOutputMetaTagUm objeto que representa uma metatag adicionada à página chamando HtmlOutput.addMetaTag(name, content).
HtmlServiceServiço para retornar HTML e outro conteúdo de texto de um script.
HtmlTemplateUm objeto de modelo para construir HTML dinamicamente.
SandboxModeUm tipo enumerado que representa os modos de sandbox que podem ser usados para scripts HtmlService do lado do cliente.
XFrameOptionsModeUm tipo enumerado que representa os modos X-Frame-Options que podem ser usados para scripts HtmlService do lado do cliente.

HtmlOutput

Métodos

MétodoTipo de retornoBreve descrição
addMetaTag(name, content)HtmlOutputAdiciona uma metatag à página.
append(addedContent)HtmlOutputAnexa novos conteúdos ao conteúdo deste HtmlOutput.
appendUntrusted(addedContent)HtmlOutputAnexa novo conteúdo ao conteúdo desse HtmlOutput, usando escape contextual.
asTemplate()HtmlTemplateRetorna um HtmlTemplate apoiado por esse HtmlOutput.
clear()HtmlOutputLimpa o conteúdo atual.
getAs(contentType)BlobRetorne os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado.
getBlob()BlobRetorne os dados dentro desse objeto como um blob.
getContent()StringRecebe o conteúdo desse HtmlOutput.
getFaviconUrl()StringRecebe o URL de uma tag de link favicon adicionada à página chamando setFaviconUrl(iconUrl).
getHeight()IntegerExtrai a altura inicial da caixa de diálogo personalizada no Documentos, Planilhas ou Formulários Google.
getMetaTags()HtmlOutputMetaTag[]Recebe uma matriz de objetos que representam metatags adicionadas à página chamando addMetaTag(name, content).
getTitle()StringRecebe o título da página de saída.
getWidth()IntegerRecebe a largura inicial da caixa de diálogo personalizada no Documentos, Planilhas ou Formulários Google.
setContent(content)HtmlOutputDefine o conteúdo desse HtmlOutput.
setFaviconUrl(iconUrl)HtmlOutputAdiciona uma tag de link para um favicon à página.
setHeight(height)HtmlOutputDefine a altura inicial da caixa de diálogo personalizada no Documentos, Planilhas ou Formulários Google.
setSandboxMode(mode)HtmlOutputEsse método agora não tem efeito. Antes, ele definia o sandbox mode usado para scripts do lado do cliente
setTitle(title)HtmlOutputDefine o título da página de saída.
setWidth(width)HtmlOutputDefine a largura inicial de uma caixa de diálogo personalizada no Documentos, Planilhas ou Formulários Google.
setXFrameOptionsMode(mode)HtmlOutputDefine o estado do cabeçalho X-Frame-Options da página, que controla a prevenção contra clickjacking.

HtmlOutputMetaTag

Métodos

MétodoTipo de retornoBreve descrição
getContent()StringRecebe o conteúdo dessa metatag.
getName()StringRecebe o nome desse HtmlOutputMetaTag.

HtmlService

Propriedades

PropriedadeTipoDescrição
SandboxModeSandboxModeUm tipo enumerado que representa os modos de sandbox que podem ser usados para scripts HtmlService do lado do cliente.
XFrameOptionsModeXFrameOptionsModeUm tipo enumerado que representa os modos X-Frame-Options que podem ser usados para scripts HtmlService do lado do cliente.

Métodos

MétodoTipo de retornoBreve descrição
createHtmlOutput()HtmlOutputCria um novo objeto HtmlOutput que pode ser retornado do script.
createHtmlOutput(blob)HtmlOutputCria um novo objeto HtmlOutput com base em um recurso BlobSource.
createHtmlOutput(html)HtmlOutputCria um novo objeto HtmlOutput que pode ser retornado do script.
createHtmlOutputFromFile(filename)HtmlOutputCria um novo objeto HtmlOutput com base em um arquivo no editor de código.
createTemplate(blob)HtmlTemplateCria um novo objeto HtmlTemplate com base em um recurso BlobSource.
createTemplate(html)HtmlTemplateCria um novo objeto HtmlTemplate que pode ser retornado do script.
createTemplateFromFile(filename)HtmlTemplateCria um novo objeto HtmlTemplate com base em um arquivo no editor de código.
getUserAgent()StringRecebe a string do user agent para o navegador atual.

HtmlTemplate

Métodos

MétodoTipo de retornoBreve descrição
evaluate()HtmlOutputAvalia esse modelo e retorna um objeto HtmlOutput.
getCode()StringGera uma string de código JavaScript, com base no arquivo de modelo, que pode ser avaliada.
getCodeWithComments()StringGera uma string de código JavaScript que pode ser avaliada, com cada linha do código contendo a linha original do modelo como um comentário.
getRawContent()StringRetorna o conteúdo não processado desse modelo.

SandboxMode

Propriedades

PropriedadeTipoDescrição
EMULATEDEnumUm modo sandbox legado que emula o modo restrito do ECMAScript 5 usando apenas os recursos disponíveis no ECMAScript 3.
IFRAMEEnumUm modo sandbox que usa o sandbox de iframe em vez da tecnologia de sandbox Caja usada pelos modos EMULATED e NATIVE.
NATIVEEnumUm modo sandbox construído sobre o modo estrito do ECMAScript 5.

XFrameOptionsMode

Propriedades

PropriedadeTipoDescrição
ALLOWALLEnumNenhum cabeçalho X-Frame-Options será definido.
DEFAULTEnumDefine o valor padrão para o cabeçalho X-Frame-Options, que preserva as suposições normais de segurança.