Class HtmlService

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
HTMLService

Serviço para retornar HTML e outro conteúdo de texto de um script.

Devido a considerações de segurança, os scripts não podem retornar conteúdo diretamente para um navegador. Em vez disso, eles precisam limpar o HTML para que ele não possa realizar ações maliciosas. Consulte a descrição de HtmlOutput para saber as limitações que isso implica no que pode ser retornado.

Propriedades

PropriedadeTipoDescrição
SandboxModeSandboxModeUma enumeração que representa os modos do sandbox que podem ser usados para scripts HtmlService do cliente.
XFrameOptionsModeXFrameOptionsModeUma enumeração 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 pelo 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 pelo 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 pelo 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 do navegador atual.

Documentação detalhada

createHtmlOutput()

Cria um novo objeto HtmlOutput que pode ser retornado pelo script.

var output = HtmlService.createHtmlOutput();

Retornar

HtmlOutput: o novo objeto HTMLOutput


createHtmlOutput(blob)

Cria um novo objeto HtmlOutput com base em um recurso BlobSource.

function createFromBlob(blob) {
  var output = HtmlService.createHtmlOutput(blob);
  return output;
}

Parâmetros

NomeTipoDescrição
blobBlobSourceObjeto de que o HTML deve ser retirado

Retornar

HtmlOutput: o novo objeto HtmlOutput.

Gera

Error: se o blob não tiver HTML ou se o HTML estiver incorreto


createHtmlOutput(html)

Cria um novo objeto HtmlOutput que pode ser retornado pelo script.

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

Parâmetros

NomeTipoDescrição
htmlStringo conteúdo a ser veiculado

Retornar

HtmlOutput: o novo objeto HTMLOutput

Gera

Error: se o HTML estiver incorreto


createHtmlOutputFromFile(filename)

Cria um novo objeto HtmlOutput com base em um arquivo no editor de código.

var output = HtmlService.createHtmlOutputFromFile('myPage');

Parâmetros

NomeTipoDescrição
filenameStringO nome do arquivo a ser usado.

Retornar

HtmlOutput: o novo objeto HtmlOutput.

Gera

Error: se o arquivo não tiver sido encontrado ou o HTML estiver incorreto


createTemplate(blob)

Cria um novo objeto HtmlTemplate com base em um recurso BlobSource.

function createFromBlob(blob) {
  var template = HtmlService.createTemplate(blob);
  return output;
}

Parâmetros

NomeTipoDescrição
blobBlobSourceO objeto de onde o HTML é retirado.

Retornar

HtmlTemplate: o novo objeto HtmlTemplate.

Gera

Error: se o blob não tiver HTML.


createTemplate(html)

Cria um novo objeto HtmlTemplate que pode ser retornado pelo script.

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

Parâmetros

NomeTipoDescrição
htmlStringo conteúdo do modelo

Retornar

HtmlTemplate: o novo objeto HtmlTemplate.


createTemplateFromFile(filename)

Cria um novo objeto HtmlTemplate com base em um arquivo no editor de código.

var template = HtmlService.createTemplateFromFile('myTemplate');

Parâmetros

NomeTipoDescrição
filenameStringO nome do arquivo a ser usado.

Retornar

HtmlTemplate: o novo objeto HtmlTemplate.

Gera

Error: se o arquivo não foi encontrado


getUserAgent()

Recebe a string do user agent do navegador atual. Retorna null para a maioria das execuções de script se não for usado em uma função doGet() ou doPost() do app da Web.

Retornar

String: a string do user agent