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
Özellik | Tür | Açıklama |
---|---|---|
SandboxMode | SandboxMode | HtmlService istemcisi için kullanılabilecek korumalı alan modlarını temsil eden bir sıralama
komut dosyaları. |
XFrameOptionsMode | XFrameOptionsMode | İstemci taraflı HtmlService komut dosyaları için kullanılabilecek X-Frame-Options modlarını temsil eden bir sıralama. |
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 | Bir BlobSource kaynağından 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üzenleyicide bir dosyadan yeni bir HtmlOutput nesnesi oluşturur. |
createTemplate(blob) | HtmlTemplate | Bir BlobSource kaynağından 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üzenleyicide bir dosyadan yeni bir HtmlTemplate nesnesi oluşturur. |
getUserAgent() | String | Geç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
Ad | Tür | Açıklama |
---|---|---|
blob | BlobSource | çı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
Ad | Tür | Açıklama |
---|---|---|
html | String | yayı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
Ad | Tür | Açıklama |
---|---|---|
filename | String | kullanı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
Ad | Tür | Açıklama |
---|---|---|
blob | BlobSource | HTML'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 <?= new Date() ?></b>');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
html | String | ş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
Ad | Tür | Açıklama |
---|---|---|
filename | String | kullanı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