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, kötü amaçlı işlemler gerçekleştirememesi için HTML'yi temizlemeleri gerekir. Bu durumun nelerin döndürülebileceğine dair sınırlamaları öğrenmek için HtmlOutput açıklamasına bakın.

Özellikler

ÖzellikTürAçıklama
SandboxModeSandboxModeİstemci tarafı HtmlService komut dosyaları için kullanılabilecek korumalı alan modlarını temsil eden bir enum.
XFrameOptionsModeXFrameOptionsModeİstemci taraflı HtmlService komut dosyaları için kullanılabilecek X-Frame-Options modlarını temsil eden bir numaralandırma.

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)HtmlOutputBlobSource 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üzenleyicideki bir dosyadan yeni bir HtmlOutput nesnesi oluşturur.
createTemplate(blob)HtmlTemplateBlobSource 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üzenleyicideki 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)

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

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

Parametreler

AdTürAçıklama
blobBlobSourceHTML'yi almak için kullanılacak nesne

Return

HtmlOutput - yeni HtmlOutput nesnesi

Dekoratif yastıklar

Error: Blob HTML içermiyorsa veya HTML hatalıysa


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

Dekoratif yastıklar

Error - HTML hatalıysa


createHtmlOutputFromFile(filename)

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

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

Parametreler

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

Return

HtmlOutput - yeni HtmlOutput nesnesi

Dekoratif yastıklar

Error - Dosya bulunamadıysa veya içindeki HTML bozuksa


createTemplate(blob)

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 çıkarılacağı nesne.

Return

HtmlTemplate - yeni HtmlTemplate nesnesi

Dekoratif yastıklar

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üzenleyicideki bir dosyadan yeni bir HtmlTemplate nesnesi oluşturur.

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

Parametreler

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

Return

HtmlTemplate - yeni HtmlTemplate nesnesi

Dekoratif yastıklar

Error - Dosya bulunamadıysa


getUserAgent()

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

Return

String — kullanıcı aracısı dizesi