Class HtmlService

HtmlService

Serviço para retornar HTML e outros conteúdos de texto de um script.

Por motivos de segurança, os scripts não podem retornar conteúdo diretamente a 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 quais limitações isso implica no que pode ser retornado.

Propriedades

Propriedade	Tipo	Descrição
SandboxMode	SandboxMode	Uma enumeração que representa os modos de sandbox que podem ser usados para scripts HtmlService do lado do cliente.
XFrameOptionsMode	XFrameOptionsMode	Um enum que representa os modos X-Frame-Options que podem ser usados para scripts HtmlService do lado do cliente.

Métodos

Método	Tipo de retorno	Breve descrição
createHtmlOutput()	HtmlOutput	Cria um novo objeto HtmlOutput que pode ser retornado do script.
createHtmlOutput(blob)	HtmlOutput	Cria um novo objeto HtmlOutput de um recurso BlobSource.
createHtmlOutput(html)	HtmlOutput	Cria um novo objeto HtmlOutput que pode ser retornado do script.
createHtmlOutputFromFile(filename)	HtmlOutput	Cria um novo objeto HtmlOutput de um arquivo no editor de código.
createTemplate(blob)	HtmlTemplate	Cria um novo objeto HtmlTemplate de um recurso BlobSource.
createTemplate(html)	HtmlTemplate	Cria um novo objeto HtmlTemplate que pode ser retornado do script.
createTemplateFromFile(filename)	HtmlTemplate	Cria um novo objeto HtmlTemplate de um arquivo no editor de código.
getUserAgent()	String	Recebe a string do user agent do navegador atual.

Documentação detalhada

createHtmlOutput()

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

const output = HtmlService.createHtmlOutput();

Retornar

HtmlOutput: o novo objeto HtmlOutput

---

createHtmlOutput(blob)

Cria um novo objeto HtmlOutput de um recurso BlobSource.

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

Parâmetros

Nome	Tipo	Descrição
blob	BlobSource	o objeto de onde extrair o HTML

Retornar

HtmlOutput: o novo objeto HtmlOutput

Gera

Error: se o blob não contiver HTML ou se o HTML estiver malformado

---

createHtmlOutput(html)

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

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

Parâmetros

Nome	Tipo	Descrição
html	String	o conteúdo a ser disponibilizado

Retornar

HtmlOutput: o novo objeto HtmlOutput

Gera

Error: se o HTML estiver incorreto

---

createHtmlOutputFromFile(filename)

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

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

Parâmetros

Nome	Tipo	Descrição
filename	String	o nome do arquivo a ser usado

Retornar

HtmlOutput: o novo objeto HtmlOutput

Gera

Error: se o arquivo não foi encontrado ou o HTML dele está incorreto.

---

createTemplate(blob)

Cria um novo objeto HtmlTemplate de um recurso BlobSource.

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

Parâmetros

Nome	Tipo	Descrição
blob	BlobSource	O objeto de onde extrair o HTML.

Retornar

HtmlTemplate: o novo objeto HtmlTemplate

Gera

Error: se o blob não contiver HTML

---

createTemplate(html)

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

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

Parâmetros

Nome	Tipo	Descrição
html	String	o conteúdo do modelo

Retornar

HtmlTemplate: o novo objeto HtmlTemplate

---

createTemplateFromFile(filename)

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

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

Parâmetros

Nome	Tipo	Descrição
filename	String	o 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, a menos que seja usado em uma função doGet() ou doPost() de um web app.

Retornar

String: a string do user agent