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 tarayıcıya içerik döndüremez. Bunun yerine, HTML'yi kötü amaçlı işlemler yapamayacak şekilde temizlemelidirler. Bu durumun iade edilebilir ürünlerle ilgili ne gibi sınırlamalara yol açtığına dair bilgi için HtmlOutput değerinin açıklamasına bakın.

Özellikler

MülkTürAçıklama
SandboxModeSandboxModeİstemci tarafı HtmlServicekodları için kullanılabilecek korumalı alan modlarını temsil eden bir enum.
XFrameOptionsModeXFrameOptionsModeİstemci tarafı HtmlService komut dosyaları için kullanılabilen X-Frame-Options modlarını temsil eden bir enum.

Yöntemler

YöntemDönüş türüKısa açıklama
createHtmlOutput()HtmlOutputKomut dosyasından döndürülebilecek 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ülebilecek yeni bir HtmlOutput nesnesi oluşturur.
createHtmlOutputFromFile(filename)HtmlOutputKod düzenleyicide 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ülebilecek yeni bir HtmlTemplate nesnesi oluşturur.
createTemplateFromFile(filename)HtmlTemplateKod düzenleyicide bir dosyadan yeni bir HtmlTemplate nesnesi oluşturur.
getUserAgent()StringMevcut tarayıcının kullanıcı aracısı dizesini alır.

Ayrıntılı dokümanlar

createHtmlOutput()

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

const output = HtmlService.createHtmlOutput();

Return

HtmlOutput: yeni HtmlOutput nesnesi

createHtmlOutput(blob)

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

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

Parametreler

AdTürAçıklama
blobBlobSourceHTML'yi alacağınız nesne

Return

HtmlOutput: Yeni HtmlOutput nesnesi

Atışlar

Error: Blob'da HTML yoksa veya HTML bozuksa

createHtmlOutput(html)

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

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

Parametreler

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

Return

HtmlOutput: yeni HtmlOutput nesnesi

Atışlar

Error: HTML hatalıysa

createHtmlOutputFromFile(filename)

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

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

Parametreler

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

Return

HtmlOutput: Yeni HtmlOutput nesnesi

Atışlar

Error: Dosya bulunamadıysa veya içindeki HTML hatalıysa

createTemplate(blob)

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

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

Parametreler

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

Return

HtmlTemplate: Yeni HtmlTemplate nesnesi

Atışlar

Error: Blob HTML içermiyorsa

createTemplate(html)

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

const 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. 

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

Parametreler

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

Return

HtmlTemplate: Yeni HtmlTemplate nesnesi

Atışlar

Error: Dosya bulunamadıysa

getUserAgent()

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

Return

String: kullanıcı aracısı dizesi