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.

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 são as limitações em relação ao 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` 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` a partir 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` a partir 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 para extrair o HTML

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

const 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 a partir 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 se o HTML nele estiver 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 o HTML será extraído.

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 a partir 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 se não for usado na função doGet() ou doPost() de um app da Web.

Retornar

String: a string do user agent