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
Özellik | Tür | Açıklama |
---|---|---|
SandboxMode | SandboxMode | İstemci tarafı HtmlService komut dosyaları için kullanılabilecek korumalı alan modlarını temsil eden bir enum. |
XFrameOptionsMode | XFrameOptionsMode | İstemci taraflı HtmlService komut dosyaları için kullanılabilecek X-Frame-Options modlarını temsil eden bir numaralandırma. |
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ğı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üzenleyicideki bir dosyadan yeni bir HtmlOutput nesnesi oluşturur. |
createTemplate(blob) | HtmlTemplate | 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üzenleyicideki 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)
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 | HTML'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
Ad | Tür | Açıklama |
---|---|---|
html | String | yayı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
Ad | Tür | Açıklama |
---|---|---|
filename | String | kullanı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
Ad | Tür | Açıklama |
---|---|---|
blob | BlobSource | HTML'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 <?= new Date() ?></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.
var template = HtmlService.createTemplateFromFile('myTemplate');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
filename | String | kullanı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