Esta página foi traduzida pela API Cloud Translation.

Class 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, é necessário limpar o HTML para que ele não possa executar ações maliciosas. Consulte a descrição de HtmlOutput para ver as limitações que isso implica no 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 scripts `HtmlService` do lado do cliente.
`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` com base em 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` com base em um arquivo no editor de código.
`getUserAgent()`	`String`	Recebe a string do user agent para o navegador atual.

Documentação detalhada

`createHtmlOutput()`

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

var output = HtmlService.createHtmlOutput();

Retorno

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`	do objeto para extrair o HTML

Retorno

HtmlOutput: o novo objeto HtmlOutput.

Gera

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

`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 que será veiculado

Retorno

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

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

Retorno

HtmlOutput: o novo objeto HtmlOutput.

Gera

Error: se o arquivo não foi encontrado ou o HTML nele está 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 o HTML obterá.

Retorno

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

Retorno

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

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

Retorno

HtmlTemplate: o novo objeto HtmlTemplate.

Gera

Error: se o arquivo não foi encontrado.

`getUserAgent()`

Recebe a string do user agent para o navegador atual. Retorna null para a maioria das execuções de script, caso não seja usado na função doGet() ou doPost() de um app da Web.

Retorno

String: a string do user agent