Diese Seite wurde von der Cloud Translation API übersetzt.

Class 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 bereinigt werden, damit keine schädlichen Aktionen ausgeführt werden können. In der Beschreibung von HtmlOutput sind die Einschränkungen aufgeführt, die sich aus der Rückgabe von Daten ergeben.

Attribute

Property	Typ	Beschreibung
`SandboxMode`	`SandboxMode`	Ein Enum-Wert, der die Sandbox-Modi darstellt, die für clientseitige `HtmlService`-Skripts verwendet werden können.
`XFrameOptionsMode`	`XFrameOptionsMode`	Ein Enum-Wert, der die `X-Frame-Options`-Modi darstellt, die für clientseitige `HtmlService`-Skripts verwendet werden können.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`createHtmlOutput()`	`HtmlOutput`	Erstellt ein neues `HtmlOutput`-Objekt, das vom Skript zurückgegeben werden kann.
`createHtmlOutput(blob)`	`HtmlOutput`	Erstellt ein neues `HtmlOutput`-Objekt aus einer `BlobSource`-Ressource.
`createHtmlOutput(html)`	`HtmlOutput`	Erstellt ein neues `HtmlOutput`-Objekt, das vom Skript zurückgegeben werden kann.
`createHtmlOutputFromFile(filename)`	`HtmlOutput`	Erstellt ein neues `HtmlOutput`-Objekt aus einer Datei im Codeeditor.
`createTemplate(blob)`	`HtmlTemplate`	Erstellt ein neues `HtmlTemplate`-Objekt aus einer `BlobSource`-Ressource.
`createTemplate(html)`	`HtmlTemplate`	Erstellt ein neues `HtmlTemplate`-Objekt, das vom Skript zurückgegeben werden kann.
`createTemplateFromFile(filename)`	`HtmlTemplate`	Erstellt ein neues `HtmlTemplate`-Objekt aus einer Datei im Codeeditor.
`getUserAgent()`	`String`	Ruft 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();

Zurücksenden

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

Name	Typ	Beschreibung
`blob`	`BlobSource`	das HTML-Objekt

Zurücksenden

HtmlOutput: das neue HtmlOutput-Objekt

Throws

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

Name	Typ	Beschreibung
`html`	`String`	die auszuliefernden Inhalte

Zurücksenden

HtmlOutput: das neue HTMLOutput-Objekt

Throws

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

Name	Typ	Beschreibung
`filename`	`String`	Der Name der Datei, die verwendet werden soll

Zurücksenden

HtmlOutput: das neue HtmlOutput-Objekt

Throws

Error: Die Datei wurde nicht gefunden oder der HTML-Code ist fehlerhaft.

`createTemplate(blob)`

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

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

Parameter

Name	Typ	Beschreibung
`blob`	`BlobSource`	Das Objekt, aus dem HTML abgerufen werden soll.

Zurücksenden

HtmlTemplate: das neue HtmlTemplate-Objekt

Throws

Error: Wenn das Blob kein HTML 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

Name	Typ	Beschreibung
`html`	`String`	den Inhalt der Vorlage

Zurücksenden

HtmlTemplate: das neue HtmlTemplate-Objekt

`createTemplateFromFile(filename)`

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

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

Parameter

Name	Typ	Beschreibung
`filename`	`String`	Der Name der Datei, die verwendet werden soll

Zurücksenden

HtmlTemplate: das neue HtmlTemplate-Objekt

Throws

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.

Zurücksenden

String: Der User-Agent-String