Class HtmlOutput

Adiciona uma metatag à página. As metatags incluídas diretamente em um arquivo HTML do Apps Script são ignorada. Somente as seguintes metatags são permitidas:

<meta name="apple-mobile-web-app-capable" content="..."/>
<meta name="google-site-verification" content="..."/>
<meta name="mobile-web-app-capable" content="..."/>
<meta name="viewport" content="..."/>

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

Parâmetros

Retornar

HtmlOutput: esta saída, para encadeamento.

Anexa novo conteúdo ao conteúdo de HtmlOutput. Use esta opção apenas para conteúdos de um fonte confiável, porque não tem escape.

// Log "<b>Hello, world!</b><p>Hello again, world.</p>"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.append('<p>Hello again, world.</p>');
Logger.log(output.getContent());

Parâmetros

Retornar

HtmlOutput: esta saída, para encadeamento.

Gera

Error: se o HTML estiver incorreto

Consulte também

• appendUntrusted(addedContent)

Anexa novo conteúdo ao conteúdo desse HtmlOutput usando escape contextual.

Esse método escapa corretamente o conteúdo com base no estado atual da HtmlOutput, para que o resultado seja uma string segura sem marcações ou efeitos laterais. Use esta opção em vez de anexar sempre que você estiver adicionando conteúdo de uma fonte não confiável, como de um usuário, para evitar acidentalmente permitir um bug de scripting em vários locais (XSS) em que o conteúdo ou a marcação que você anexa causa uma execução inesperada de código.

// Log "<b>Hello, world!</b>&lt;p&gt;Hello again, world.&lt;/p&gt;"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.appendUntrusted('<p>Hello again, world.</p>');
Logger.log(output.getContent());

Parâmetros

Retornar

HtmlOutput: esta saída, para encadeamento.

Gera

Error: se o HTML estiver muito incorreto.

Consulte também

• append(addedContent)

Retorna um HtmlTemplate apoiado por esse HtmlOutput. Esse método pode ser usado para criar um modelo de forma incremental. Futuras alterações em HtmlOutput afetarão o conteúdo de o HtmlTemplate também.

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

Retornar

HtmlTemplate: o novo HtmlTemplate.

Limpa o conteúdo atual.

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

Retornar

HtmlOutput: esta saída, para encadeamento.

Retorna os dados dentro desse objeto como um blob convertido no tipo de conteúdo especificado. Isso adiciona a extensão adequada ao nome do arquivo, por exemplo, "myfile.pdf". No entanto, pressupõe que a parte do nome do arquivo que segue o ponto final (se houver) é uma que deve ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ListaShopping.12.25.pdf".

Para acessar as cotas diárias para conversões, consulte Cotas do Google Serviços. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a medidas cotas.

Parâmetros

Retornar

Blob: os dados como um blob.

Retorne os dados dentro desse objeto como um blob.

Retornar

Blob: os dados como um blob.

Recebe o conteúdo desse HtmlOutput.

// Log "<b>Hello, world!</b>"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
Logger.log(output.getContent());

Retornar

String: o conteúdo veiculado.

Recebe o URL de uma tag de link de favicon adicionada à página. Para isso, chame setFaviconUrl(iconUrl). As tags de link Favicon incluídas diretamente em um arquivo HTML do Apps Script são: ignorada.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');
Logger.log(output.getFaviconUrl());

Retornar

String: é o URL da imagem do favicon.

Recebe a altura inicial da caixa de diálogo personalizada no Google. Documentos, Planilhas ou Formulários. Se a HtmlOutput for publicada como um app da Web, esse retorna null. Para redimensionar uma caixa de diálogo que já está aberta, chame google.script.host.setHeight(height) no código do lado do cliente.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setHeight(200);
Logger.log(output.getHeight());

Retornar

Integer: a altura, em pixels.

Recebe uma matriz de objetos que representam metatags adicionadas à página chamando addMetaTag(name, content). As metatags incluídas diretamente em um arquivo HTML do Apps Script são ignorada.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

var tags = output.getMetaTags();
Logger.log('<meta name="%s" content="%s"/>', tags[0].getName(), tags[0].getContent());

Retornar

HtmlOutputMetaTag[]: uma matriz de objetos que representam metatags adicionadas à página chamando addMetaTag(name, content).

Recebe o título da página de saída. Observe que o elemento <title> O elemento HTML é ignorado.

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

Retornar

String: o título da página.

Recebe a largura inicial da caixa de diálogo personalizada no Google. Documentos, Planilhas ou Formulários. Se a HtmlOutput for publicada como um app da Web, esse retorna null. Para redimensionar uma caixa de diálogo que já está aberta, chame google.script.host.setWidth(width) no código do lado do cliente.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setWidth(200);
Logger.log(output.getWidth());

Retornar

Integer: a largura em pixels.

Define o conteúdo deste HtmlOutput.

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

Parâmetros

Retornar

HtmlOutput: esta saída, para encadeamento.

Gera

Error: se o HTML estiver incorreto

Adiciona uma tag de link para um favicon à página. Tags de link favicon incluídas diretamente em um aplicativo do arquivo HTML de script serão ignorados.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');

Parâmetros

Retornar

HtmlOutput: esta saída, para encadeamento.

Define a altura inicial da caixa de diálogo personalizada no Google Documentos, Planilhas ou Formulários. Se a HtmlOutput for publicada como um app da Web, esse não tem efeito. Para redimensionar uma caixa de diálogo que já está aberta, chame google.script.host.setHeight(height) no código do lado do cliente.

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

Parâmetros

Retornar

HtmlOutput: esta saída, para encadeamento.

Esse método agora não tem efeito. Antes, ele definia o sandbox mode usado para scripts do lado do cliente. Para proteger os usuários contra a exibição de HTML ou O JavaScript, o código do lado do cliente fornecido pelo serviço HTML é executado em um sandbox de segurança que impõem restrições ao código. Originalmente, esse método permitia que os autores de scripts escolhessem entre versões diferentes do sandbox, mas agora todos os scripts usam o modo IFRAME independentemente do modo sandbox definido. Para mais informações, consulte o guia para restrições no serviço HTML.

O modo IFRAME impõe muito menos restrições do que os outros modos de sandbox. é mais rápido, mas não funciona em certos navegadores mais antigos, incluindo o Internet Explorer 9. O modo sandbox pode ser lido em um script do lado do cliente inspecionando google.script.sandbox.mode. Essa propriedade retorna o modo real no cliente, que pode ser diferente do modo solicitado no servidor se o modo solicitado não for suportado no navegador do usuário.

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>

Parâmetros

Retornar

HtmlOutput: esta saída, para encadeamento.

Define o título da página de saída. Para aplicativos da Web, é o título da página inteira, enquanto para HtmlOutput mostrado nas Planilhas Google, este é o título da caixa de diálogo.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setTitle('My First Page');

Parâmetros

Retornar

HtmlOutput: esta saída, para encadeamento.

Define a largura inicial de uma caixa de diálogo personalizada no Google Documentos, Planilhas ou Formulários. Se a HtmlOutput for publicada como um app da Web, esse não tem efeito. Para redimensionar uma caixa de diálogo que já está aberta, chame google.script.host.setWidth(width) no código do lado do cliente.

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

Parâmetros

Retornar

HtmlOutput: esta saída, para encadeamento.

Define o estado do cabeçalho X-Frame-Options da página, que controla o clickjacking. prevenção.

Definir XFrameOptionsMode.ALLOWALL permite que qualquer site adicione a página a um iframe. Assim, o o desenvolvedor deve implementar sua própria proteção contra clickjacking.

Se um script não define um modo X-Frame-Options, o Apps Script usa o modo XFrameOptionsMode.DEFAULT como padrão.

// Serve HTML with no X-Frame-Options header (in Apps Script server-side code).
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);

Parâmetros

Retornar

HtmlOutput: esta saída, para encadeamento.