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 das HTML bereinigt werden, damit keine schädlichen Aktionen ausgeführt werden können. In der Beschreibung von HtmlOutput finden Sie Informationen zu den Einschränkungen, die sich daraus für die zurückgegebenen Daten ergeben.

Properties

Attribut	Typ	Beschreibung
SandboxMode	SandboxMode	Ein Enum, das die Sandbox-Modi darstellt, die für clientseitige HtmlService-Skripts verwendet werden können.
XFrameOptionsMode	XFrameOptionsMode	Ein Enum, das die X-Frame-Options-Modi darstellt, die für clientseitige HtmlService-Scripts 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 Code-Editor.
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 Code-Editor.
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.

const output = HtmlService.createHtmlOutput();

Rückflug

HtmlOutput – das neue HtmlOutput-Objekt

---

createHtmlOutput(blob)

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

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

Parameter

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

Rückflug

HtmlOutput – das neue HtmlOutput-Objekt

Löst

Error – wenn der 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.

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

Parameter

Name	Typ	Beschreibung
html	String	die bereitzustellenden Inhalte

Rückflug

HtmlOutput – das neue HtmlOutput-Objekt

Löst

Error: wenn das HTML fehlerhaft ist

---

createHtmlOutputFromFile(filename)

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

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

Parameter

Name	Typ	Beschreibung
filename	String	Der Name der zu verwendenden Datei.

Rückflug

HtmlOutput – das neue HtmlOutput-Objekt

Löst

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) {
  const template = HtmlService.createTemplate(blob);
  const output = template.evaluate();
  return output;
}

Parameter

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

Rückflug

HtmlTemplate – das neue HtmlTemplate-Objekt

Löst

Error – wenn das Blob keinen HTML-Code enthält

---

createTemplate(html)

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

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

Parameter

Name	Typ	Beschreibung
html	String	den Inhalt der Vorlage

Rückflug

HtmlTemplate – das neue HtmlTemplate-Objekt

---

createTemplateFromFile(filename)

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

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

Parameter

Name	Typ	Beschreibung
filename	String	Der Name der zu verwendenden Datei.

Rückflug

HtmlTemplate – das neue HtmlTemplate-Objekt

Löst

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 die Funktion nicht in der Funktion doGet() oder doPost() einer Web-App verwendet wird.

Rückflug

String – der User-Agent-String