Class HtmlService

HtmlService

Dienst zum Zurückgeben von HTML- und anderen Textinhalten aus einem Skript

Aus Sicherheitsgründen können Skripts keine Inhalte direkt an einen Browser zurückgeben. Stattdessen muss der HTML-Code so bereinigt werden, dass er keine schädlichen Aktionen ausführen kann. In der Beschreibung von HtmlOutput finden Sie weitere Informationen zu den Einschränkungen dafür, was zurückgegeben werden kann.

Attribute

PropertyTypBeschreibung
SandboxModeSandboxModeEin Enum, das die Sandbox-Modi darstellt, die für clientseitige HtmlService-Skripts verwendet werden können.
XFrameOptionsModeXFrameOptionsModeEin Enum-Wert, der die X-Frame-Options-Modi darstellt, die für clientseitige HtmlService-Skripts verwendet werden können.

Methoden

MethodeRückgabetypKurzbeschreibung
createHtmlOutput()HtmlOutputErstellt ein neues HtmlOutput-Objekt, das vom Skript zurückgegeben werden kann.
createHtmlOutput(blob)HtmlOutputErstellt ein neues HtmlOutput-Objekt aus einer BlobSource-Ressource.
createHtmlOutput(html)HtmlOutputErstellt ein neues HtmlOutput-Objekt, das vom Skript zurückgegeben werden kann.
createHtmlOutputFromFile(filename)HtmlOutputErstellt ein neues HtmlOutput-Objekt aus einer Datei im Codeeditor.
createTemplate(blob)HtmlTemplateErstellt ein neues HtmlTemplate-Objekt aus einer BlobSource-Ressource.
createTemplate(html)HtmlTemplateErstellt ein neues HtmlTemplate-Objekt, das vom Skript zurückgegeben werden kann.
createTemplateFromFile(filename)HtmlTemplateErstellt ein neues HtmlTemplate-Objekt aus einer Datei im Codeeditor.
getUserAgent()StringRuft den User-Agent-String für den aktuellen Browser ab.

Detaillierte Dokumentation

createHtmlOutput()

Erstellt ein neues HtmlOutput-Objekt, das vom Skript zurückgegeben werden kann.

var output = HtmlService.createHtmlOutput();

Return

HtmlOutput – das neue HTMLOutput-Objekt


createHtmlOutput(blob)

Erstellt ein neues HtmlOutput-Objekt aus einer BlobSource-Ressource.

function createFromBlob(blob) {
  var output = HtmlService.createHtmlOutput(blob);
  return output;
}

Parameter

NameTypBeschreibung
blobBlobSourceDas Objekt, aus dem HTML abgerufen werden soll

Return

HtmlOutput – das neue HtmlOutput-Objekt

Löst aus

Error: Wenn das Blob keinen HTML-Code enthält oder der HTML-Code fehlerhaft ist


createHtmlOutput(html)

Erstellt ein neues HtmlOutput-Objekt, das vom Skript zurückgegeben werden kann.

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

Parameter

NameTypBeschreibung
htmlStringfür die Bereitstellung von Inhalten

Return

HtmlOutput – das neue HTMLOutput-Objekt

Löst aus

Error: wenn der HTML-Code fehlerhaft ist


createHtmlOutputFromFile(filename)

Erstellt ein neues HtmlOutput-Objekt aus einer Datei im Codeeditor.

var output = HtmlService.createHtmlOutputFromFile('myPage');

Parameter

NameTypBeschreibung
filenameStringden Namen der zu verwendenden Datei

Return

HtmlOutput – das neue HtmlOutput-Objekt

Löst aus

Error: Wenn die Datei nicht gefunden wurde oder der HTML-Code darin fehlerhaft ist


createTemplate(blob)

Erstellt ein neues HtmlTemplate-Objekt aus einer BlobSource-Ressource.

function createFromBlob(blob) {
  var template = HtmlService.createTemplate(blob);
  return output;
}

Parameter

NameTypBeschreibung
blobBlobSourceObjekt, aus dem HTML abgerufen werden soll

Return

HtmlTemplate – das neue HtmlTemplate-Objekt

Löst aus

Error: Wenn das Blob keinen HTML-Code enthält.


createTemplate(html)

Erstellt ein neues HtmlTemplate-Objekt, das vom Skript zurückgegeben werden kann.

var template = HtmlService.createTemplate('<b>The time is &lt;?= new Date() ?&gt;</b>');

Parameter

NameTypBeschreibung
htmlStringden Inhalt der Vorlage

Return

HtmlTemplate – das neue HtmlTemplate-Objekt


createTemplateFromFile(filename)

Erstellt ein neues HtmlTemplate-Objekt aus einer Datei im Codeeditor.

var template = HtmlService.createTemplateFromFile('myTemplate');

Parameter

NameTypBeschreibung
filenameStringden Namen der zu verwendenden Datei

Return

HtmlTemplate – das neue HtmlTemplate-Objekt

Löst aus

Error: Wenn die Datei nicht gefunden wurde


getUserAgent()

Ruft den User-Agent-String für den aktuellen Browser ab. Gibt für die meisten Skriptausführungen null zurück, wenn sie nicht in der doGet()- oder doPost()-Funktion einer Webanwendung verwendet werden.

Return

String: der User-Agent-String