Class HtmlOutput

Добавляет метатег на страницу. Метатеги, включенные непосредственно в HTML-файл Apps Script, игнорируются. Разрешены только следующие метатеги:

<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');

Параметры

Возвращаться

HtmlOutput — этот вывод для цепочки.

Добавляет новый контент к содержимому этого HtmlOutput . Используйте это только для контента из надежного источника, потому что он не экранирован.

// 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());

Параметры

Возвращаться

HtmlOutput — этот вывод для цепочки.

Броски

Error — если HTML неверный формат

Смотрите также

• appendUntrusted(addedContent)

Добавляет новый контент к содержимому этого HtmlOutput , используя контекстное экранирование.

Этот метод правильно экранирует содержимое на основе текущего состояния HtmlOutput , так что результатом является безопасная строка без разметки или побочных эффектов. Используйте это вместо использования добавления всякий раз, когда вы добавляете содержимое из ненадежного источника, например от пользователя, чтобы избежать случайного возникновения ошибки межсайтового скриптинга (XSS), когда добавляемое содержимое или разметка вызывает неожиданное выполнение кода.

// 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());

Параметры

Возвращаться

HtmlOutput — этот вывод для цепочки.

Броски

Error — если HTML очень искажен

Смотрите также

• append(addedContent)

Возвращает HtmlTemplate , поддерживаемый этим HtmlOutput . Этот метод можно использовать для постепенного создания шаблона. Будущие изменения в HtmlOutput повлияют на содержимое HtmlTemplate .

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

Возвращаться

HtmlTemplate — новый HtmlTemplate .

Очищает текущий контент.

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

Возвращаться

HtmlOutput — этот вывод для цепочки.

Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента. Этот метод добавляет соответствующее расширение к имени файла, например, «myfile.pdf». Однако предполагается, что часть имени файла, которая следует за последней точкой (если она есть), является существующим расширением, которое следует заменить. Следовательно, «Список покупок.12.25.2014» становится «Список покупок.12.25.pdf».

Чтобы просмотреть дневные квоты на конверсии, см. Квоты для сервисов Google . На вновь созданные домены Google Workspace могут временно распространяться более строгие квоты.

Параметры

Возвращаться

Blob — данные в виде большого двоичного объекта.

Верните данные внутри этого объекта в виде большого двоичного объекта.

Возвращаться

Blob — данные в виде большого двоичного объекта.

Получает содержимое этого HtmlOutput .

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

Возвращаться

String — контент, который обслуживается.

Получает URL-адрес тега ссылки фавикона, добавленного на страницу, путем вызова setFaviconUrl(iconUrl) . Теги ссылок Favicon, включенные непосредственно в HTML-файл Apps Script, игнорируются.

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

Возвращаться

String — URL-адрес изображения фавикона.

Получает начальную высоту пользовательского диалогового окна в Google Docs, Sheets или Forms. Если вместо этого HtmlOutput публикуется как веб-приложение, этот метод возвращает значение null . Чтобы изменить размер уже открытого диалогового окна, вызовите google.script.host.setHeight(height) в клиентском коде.

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

Возвращаться

Integer — высота в пикселях.

Получает массив объектов, представляющих метатеги, добавленные на страницу путем вызова addMetaTag(name, content) . Метатеги, включенные непосредственно в HTML-файл Apps Script, игнорируются.

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());

Возвращаться

HtmlOutputMetaTag[] — Массив объектов, представляющих метатеги, добавленные на страницу путем вызова addMetaTag(name, content) .

Получает заголовок выходной страницы. Обратите внимание, что HTML-элемент <title> игнорируется.

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

Возвращаться

String — заголовок страницы.

Получает начальную ширину настраиваемого диалогового окна в Google Docs, Sheets или Forms. Если вместо этого HtmlOutput публикуется как веб-приложение, этот метод возвращает значение null . Чтобы изменить размер уже открытого диалогового окна, вызовите google.script.host.setWidth(width) в клиентском коде.

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

Возвращаться

Integer — ширина в пикселях.

Задает содержимое этого HtmlOutput .

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

Параметры

Возвращаться

HtmlOutput — этот вывод для цепочки.

Броски

Error — если HTML неверный формат

Добавляет тег ссылки для фавикона на страницу. Теги ссылок Favicon, включенные непосредственно в HTML-файл Apps Script, игнорируются.

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

Параметры

Возвращаться

HtmlOutput — этот вывод для цепочки.

Задает начальную высоту настраиваемого диалогового окна в Документах Google, Таблицах или Формах. Если вместо этого HtmlOutput публикуется как веб-приложение, этот метод не действует. Чтобы изменить размер уже открытого диалогового окна, вызовите google.script.host.setHeight(height) в клиентском коде.

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

Параметры

Возвращаться

HtmlOutput — этот вывод для цепочки.

Этот метод теперь не имеет никакого эффекта — ранее он устанавливал sandbox mode используемый для клиентских скриптов. Чтобы защитить пользователей от предоставления вредоносного кода HTML или JavaScript, код на стороне клиента, обслуживаемый службой HTML, выполняется в изолированной программной среде безопасности, которая накладывает ограничения на код. Первоначально этот метод позволял авторам скриптов выбирать между различными версиями песочницы, но теперь все скрипты используют режим IFRAME независимо от того, какой режим песочницы установлен. Дополнительные сведения см. в руководстве по ограничениям в службе HTML .

Режим IFRAME накладывает гораздо меньше ограничений, чем другие режимы песочницы, и работает быстрее, но вообще не работает в некоторых старых браузерах, включая Internet Explorer 9. Режим песочницы можно прочитать в сценарии на стороне клиента, google.script.sandbox.mode . Обратите внимание, что это свойство возвращает фактический режим на клиенте, который может отличаться от режима, запрошенного на сервере, если запрошенный режим не поддерживается в браузере пользователя.

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

Параметры

Возвращаться

HtmlOutput — этот вывод для цепочки.

Устанавливает заголовок выходной страницы. Для веб-приложений это заголовок всей страницы, а для HtmlOutput , отображаемого в Google Таблицах, это заголовок диалогового окна.

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

Параметры

Возвращаться

HtmlOutput — этот вывод для цепочки.

Устанавливает начальную ширину настраиваемого диалогового окна в Google Docs, Sheets или Forms. Если вместо этого HtmlOutput публикуется как веб-приложение, этот метод не действует. Чтобы изменить размер уже открытого диалогового окна, вызовите google.script.host.setWidth(width) в клиентском коде.

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

Параметры

Возвращаться

HtmlOutput — этот вывод для цепочки.

Устанавливает состояние заголовка X-Frame-Options страницы, который управляет предотвращением кликджекинга.

Параметр XFrameOptionsMode.ALLOWALL позволяет любому сайту использовать iframe для страницы, поэтому разработчик должен реализовать собственную защиту от кликджекинга.

Если сценарий не устанавливает режим X-Frame-Options , сценарий приложений использует режим XFrameOptionsMode.DEFAULT по умолчанию.

// 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);

Параметры

Возвращаться

HtmlOutput — этот вывод для цепочки.