Class HtmlService

HtmlService

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

Güvenlik nedeniyle, komut dosyaları doğrudan bir tarayıcıya içerik döndüremez. Bunun yerine HTML'yi kötü amaçlı işlemler gerçekleştirememesi için arındırmalıdır. Şu açıklamaya bakın: Bunun iade alınabilecek öğelere dair ne tür sınırlamalar getirdiğine dair HtmlOutput.

Özellikler

ÖzellikTürAçıklama
SandboxModeSandboxModeHtmlService istemcisi için kullanılabilecek korumalı alan modlarını temsil eden bir sıralama komut dosyaları.
XFrameOptionsModeXFrameOptionsModeİstemci taraflı HtmlService komut dosyaları için kullanılabilecek X-Frame-Options modlarını temsil eden bir sıralama.

Yöntemler

YöntemDönüş türüKısa açıklama
createHtmlOutput()HtmlOutputKomut dosyasından döndürülebilen yeni bir HtmlOutput nesnesi oluşturur.
createHtmlOutput(blob)HtmlOutputBir BlobSource kaynağından yeni bir HtmlOutput nesnesi oluşturur.
createHtmlOutput(html)HtmlOutputKomut dosyasından döndürülebilen yeni bir HtmlOutput nesnesi oluşturur.
createHtmlOutputFromFile(filename)HtmlOutputKod düzenleyicide bir dosyadan yeni bir HtmlOutput nesnesi oluşturur.
createTemplate(blob)HtmlTemplateBir BlobSource kaynağından yeni bir HtmlTemplate nesnesi oluşturur.
createTemplate(html)HtmlTemplateKomut dosyasından döndürülebilen yeni bir HtmlTemplate nesnesi oluşturur.
createTemplateFromFile(filename)HtmlTemplateKod düzenleyicide bir dosyadan yeni bir HtmlTemplate nesnesi oluşturur.
getUserAgent()StringGeçerli tarayıcı için 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.

var output = HtmlService.createHtmlOutput();

Return

HtmlOutput — yeni HTMLExit nesnesi


createHtmlOutput(blob)

Bir BlobSource kaynağından yeni bir HtmlOutput nesnesi oluşturur.

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

Parametreler

AdTürAçıklama
blobBlobSourceçıkarılacak nesneyi

Return

HtmlOutput — yeni HtmlOutput nesnesi

Fırlatma

Error — Blob HTML içermiyorsa veya HTML hatalı biçimlendirilmişse


createHtmlOutput(html)

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

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

Parametreler

AdTürAçıklama
htmlStringyayınlanacak içerik

Return

HtmlOutput — yeni HTMLExit nesnesi

Fırlatma

Error — HTML bozuksa


createHtmlOutputFromFile(filename)

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

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

Parametreler

AdTürAçıklama
filenameStringkullanılacak dosyanın adı

Return

HtmlOutput — yeni HtmlOutput nesnesi

Fırlatma

Error — dosya bulunamadıysa veya içerdiği HTML bozuksa


createTemplate(blob)

Bir BlobSource kaynağından yeni bir HtmlTemplate nesnesi oluşturur.

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

Parametreler

AdTürAçıklama
blobBlobSourceHTML'nin alınacağı nesne.

Return

HtmlTemplate — yeni HtmlTemplate nesnesi

Fırlatma

Error - blob HTML içermiyorsa


createTemplate(html)

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

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

Parametreler

AdTürAçıklama
htmlStringşablonun içeriği

Return

HtmlTemplate — yeni HtmlTemplate nesnesi


createTemplateFromFile(filename)

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

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

Parametreler

AdTürAçıklama
filenameStringkullanılacak dosyanın adı

Return

HtmlTemplate — yeni HtmlTemplate nesnesi

Fırlatma

Error - dosya bulunamadıysa


getUserAgent()

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

Return

String — kullanıcı aracısı dizesi