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

Propriedade	Tipo	Descrição
`SandboxMode`	`SandboxMode`	Uma enumeração que representa os modos do sandbox que podem ser usados para scripts `HtmlService` do cliente.
`XFrameOptionsMode`	`XFrameOptionsMode`	Uma enumeração 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 pelo 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 pelo 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 pelo 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 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

Nome	Tipo	Descrição
`blob`	`BlobSource`	Objeto 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

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

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

Nome	Tipo	Descrição
`blob`	`BlobSource`	O 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

Nome	Tipo	Descrição
`html`	`String`	o 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

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 se não for usado em uma função doGet() ou doPost() do app da Web.

Retornar

String: a string do user agent