Class HtmlService

HtmlService

Bir komut dosyasından HTML ve diğer metin içeriklerini döndürme hizmeti.

Güvenlik nedeniyle komut dosyaları, içeriği doğrudan tarayıcıya döndüremez. Bunun yerine, HTML'yi kötü amaçlı işlemler yapamayacak şekilde temizlemeleri gerekir. Hangi öğelerin döndürülebileceğiyle ilgili sınırlamalar için HtmlOutput açıklamasını inceleyin.

Özellikler

Mülk	Tür	Açıklama
SandboxMode	SandboxMode	İstemci tarafı HtmlService komut dosyaları için kullanılabilecek test ortamı modlarını temsil eden bir enum.
XFrameOptionsMode	XFrameOptionsMode	İstemci tarafı HtmlService komut dosyaları için kullanılabilecek X-Frame-Options modlarını temsil eden bir enum.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
createHtmlOutput()	HtmlOutput	Komut dosyasından döndürülebilen yeni bir HtmlOutput nesnesi oluşturur.
createHtmlOutput(blob)	HtmlOutput	BlobSource kaynağını kullanarak yeni bir HtmlOutput nesnesi oluşturur.
createHtmlOutput(html)	HtmlOutput	Komut dosyasından döndürülebilen yeni bir HtmlOutput nesnesi oluşturur.
createHtmlOutputFromFile(filename)	HtmlOutput	Kod düzenleyicideki bir dosyadan yeni bir HtmlOutput nesnesi oluşturur.
createTemplate(blob)	HtmlTemplate	BlobSource kaynağını kullanarak yeni bir HtmlTemplate nesnesi oluşturur.
createTemplate(html)	HtmlTemplate	Komut dosyasından döndürülebilen yeni bir HtmlTemplate nesnesi oluşturur.
createTemplateFromFile(filename)	HtmlTemplate	Kod düzenleyicideki bir dosyadan yeni bir HtmlTemplate nesnesi oluşturur.
getUserAgent()	String	Geçerli tarayıcının kullanıcı aracısı dizesini alır.

Ayrıntılı belgeler

createHtmlOutput()

Komut dosyasından döndürülebilen yeni bir HtmlOutput nesnesi oluşturur.

const output = HtmlService.createHtmlOutput();

Return

HtmlOutput: Yeni HtmlOutput nesnesi

---

createHtmlOutput(blob)

BlobSource kaynağını kullanarak yeni bir HtmlOutput nesnesi oluşturur.

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

Parametreler

Ad	Tür	Açıklama
blob	BlobSource	HTML'nin alınacağı nesne

Return

HtmlOutput: Yeni HtmlOutput nesnesi

Verdiği hatalar

Error: Blob HTML içermiyorsa veya HTML bozuksa

---

createHtmlOutput(html)

Komut dosyasından döndürülebilen yeni bir HtmlOutput nesnesi oluşturur.

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

Parametreler

Ad	Tür	Açıklama
html	String	sunulacak içerik

Return

HtmlOutput: Yeni HtmlOutput nesnesi

Verdiği hatalar

Error: HTML hatalı biçimlendirilmişse

---

createHtmlOutputFromFile(filename)

Kod düzenleyicideki bir dosyadan yeni bir HtmlOutput nesnesi oluşturur.

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

Parametreler

Ad	Tür	Açıklama
filename	String	Kullanılacak dosyanın adı

Return

HtmlOutput: Yeni HtmlOutput nesnesi

Verdiği hatalar

Error: Dosya bulunamadıysa veya dosyadaki HTML hatalıysa

---

createTemplate(blob)

BlobSource kaynağını kullanarak yeni bir HtmlTemplate nesnesi oluşturur.

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

Parametreler

Ad	Tür	Açıklama
blob	BlobSource	HTML'nin alınacağı nesne.

Return

HtmlTemplate: Yeni HtmlTemplate nesnesi

Verdiği hatalar

Error: Blob HTML içermiyorsa

---

createTemplate(html)

Komut dosyasından döndürülebilen yeni bir HtmlTemplate nesnesi oluşturur.

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

Parametreler

Ad	Tür	Açıklama
html	String	şablonun içeriği

Return

HtmlTemplate: Yeni HtmlTemplate nesnesi

---

createTemplateFromFile(filename)

Kod düzenleyicideki bir dosyadan yeni bir HtmlTemplate nesnesi oluşturur.

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

Parametreler

Ad	Tür	Açıklama
filename	String	Kullanılacak dosyanın adı

Return

HtmlTemplate: Yeni HtmlTemplate nesnesi

Verdiği hatalar

Error: Dosya bulunamadıysa

---

getUserAgent()

Geçerli tarayıcının kullanıcı aracısı dizesini alır. Bir web uygulamasının null veya doPost() işlevinde kullanılmıyorsa çoğu komut dosyası yürütme işlemi için doGet() değerini döndürür.

Return

String: Kullanıcı aracısı dizesi