Esta página foi traduzida pela API Cloud Translation.

Class HtmlService

Serviço para retornar HTML e outros conteúdos 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 devem sanitizar o HTML para que ele não execute ações maliciosas. Consulte a descrição HtmlOutput para as limitações que isso implica sobre o que pode ser retornado.

Propriedades

Propriedade	Tipo	Descrição
`SandboxMode`	`SandboxMode`	Um tipo enumerado que representa os modos de sandbox que podem ser usados para `HtmlService` do lado do cliente scripts.
`XFrameOptionsMode`	`XFrameOptionsMode`	Um tipo enumerado 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` com base em 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` com base em 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.

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

Nome	Tipo	Descrição
`blob`	`BlobSource`	o objeto do qual extrair o HTML

Retornar

HtmlOutput: o novo objeto HtmlOutput.

Gera

Error: se o blob não contém HTML ou o HTML está malformado

`createHtmlOutput(html)`

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

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

Parâmetros

Nome	Tipo	Descrição
`html`	`String`	o 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 de um arquivo no editor de código.

var 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 for encontrado ou o HTML dele 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

Nome	Tipo	Descrição
`blob`	`BlobSource`	O objeto do qual extrair o HTML.

Retornar

HtmlTemplate: o novo objeto HtmlTemplate.

Gera

Error: se o blob não contém HTML

`createTemplate(html)`

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

var 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.

var 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 for encontrado.

`getUserAgent()`

Recebe a string do user agent do navegador atual. Retorna null para a maioria dos scripts. a menos que sejam usadas na função doGet() ou doPost() de um app da Web.

Retornar

String: a string do user agent