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». Однако предполагается, что часть имени файла, следующая за последней точкой (если таковая имеется), является существующим расширением, которое следует заменить. Следовательно, «Список покупок.25.12.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) . Теги ссылок на значок значка, включенные непосредственно в 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. Если 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. Если 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 имеет неправильный формат.

Добавляет на страницу тег ссылки для значка. Теги ссылок на значок значка, включенные непосредственно в 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 Sheets, это заголовок диалога.

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

Параметры

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

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

Устанавливает начальную ширину пользовательского диалогового окна в Документах, Таблицах или Формах Google. Если вместо этого 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 , Apps Script использует режим 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 — этот вывод для цепочки.