Class HtmlService

HtmlService

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

Aus Sicherheitsgründen können Skripts Inhalte nicht direkt an einen Browser zurückgeben. Stattdessen muss der HTML-Code bereinigt werden, damit er keine schädlichen Aktionen ausführen kann. Weitere Informationen finden Sie in der Beschreibung der HtmlOutput für die damit verbundenen Einschränkungen für die zurückgegebenen Inhalte.

Attribute

AttributTypBeschreibung
SandboxModeSandboxModeEin Enum-Wert, der die Sandbox-Modi darstellt, die für das clientseitige HtmlService verwendet werden können Skripts erstellt.
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 Code-Editor.
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 Code-Editor.
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();

Rückflug

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, um HTML aus dem

Rückflug

HtmlOutput – das neue HtmlOutput-Objekt

Löst aus

Error – wenn das Blob keinen HTML-Code oder ein fehlerhaftes Format enthält


createHtmlOutput(html)

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

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

Parameter

NameTypBeschreibung
htmlStringder für die Auslieferung

Rückflug

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 Code-Editor.

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

Parameter

NameTypBeschreibung
filenameStringDen Namen der zu verwendenden Datei

Rückflug

HtmlOutput – das neue HtmlOutput-Objekt

Löst aus

Error – wenn die Datei nicht gefunden wurde oder der HTML-Code 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
blobBlobSourceDas Objekt, aus dem HTML abgerufen werden soll.

Rückflug

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
htmlStringInhalt der Vorlage

Rückflug

HtmlTemplate – das neue HtmlTemplate-Objekt


createTemplateFromFile(filename)

Erstellt ein neues HtmlTemplate-Objekt aus einer Datei im Code-Editor.

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

Parameter

NameTypBeschreibung
filenameStringDen Namen der zu verwendenden Datei

Rückflug

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 Skripts null zurück ausgeführt werden, wenn sie nicht in der doGet()- oder doPost()-Funktion einer Webanwendung verwendet werden.

Rückflug

String – User-Agent-String