Class HtmlService

HtmlService

透過指令碼傳回 HTML 和其他文字內容的服務。

基於安全考量，指令碼無法直接將內容傳回瀏覽器。 它們必須掃毒 HTML，而無法執行惡意動作。請參閱 HtmlOutput，瞭解這個值的限制代表可傳回的內容。

屬性

屬性	類型	說明
SandboxMode	SandboxMode	列舉代表用戶端 HtmlService 可使用的沙箱模式 指令碼
XFrameOptionsMode	XFrameOptionsMode	列舉代表可用於用戶端 HtmlService 指令碼的 X-Frame-Options 模式。

方法

方法	傳回類型	簡短說明
createHtmlOutput()	HtmlOutput	建立可從指令碼傳回的新 HtmlOutput 物件。
createHtmlOutput(blob)	HtmlOutput	從 BlobSource 資源建立新的 HtmlOutput 物件。
createHtmlOutput(html)	HtmlOutput	建立可從指令碼傳回的新 HtmlOutput 物件。
createHtmlOutputFromFile(filename)	HtmlOutput	根據程式碼編輯器中的檔案，建立新的 HtmlOutput 物件。
createTemplate(blob)	HtmlTemplate	從 BlobSource 資源建立新的 HtmlTemplate 物件。
createTemplate(html)	HtmlTemplate	建立可從指令碼傳回的新 HtmlTemplate 物件。
createTemplateFromFile(filename)	HtmlTemplate	根據程式碼編輯器中的檔案，建立新的 HtmlTemplate 物件。
getUserAgent()	String	取得目前瀏覽器的使用者代理程式字串。

內容詳盡的說明文件

createHtmlOutput()

建立可從指令碼傳回的新 HtmlOutput 物件。

var output = HtmlService.createHtmlOutput();

回攻員

HtmlOutput：新的 HtmlOutput 物件

---

createHtmlOutput(blob)

從 BlobSource 資源建立新的 HtmlOutput 物件。

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

參數

名稱	類型	說明
blob	BlobSource	以便取得 HTML

回攻員

HtmlOutput：新的 HtmlOutput 物件

擲回

Error：如果 blob 不包含 HTML，或是 HTML 格式錯誤

---

createHtmlOutput(html)

建立可從指令碼傳回的新 HtmlOutput 物件。

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

參數

名稱	類型	說明
html	String	要放送的內容

回攻員

HtmlOutput：新的 HtmlOutput 物件

擲回

Error：如果 HTML 格式錯誤

---

createHtmlOutputFromFile(filename)

根據程式碼編輯器中的檔案，建立新的 HtmlOutput 物件。

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

參數

名稱	類型	說明
filename	String	要使用的檔案名稱

回攻員

HtmlOutput：新的 HtmlOutput 物件

擲回

Error：如果找不到檔案或其中的 HTML 格式有誤

---

createTemplate(blob)

從 BlobSource 資源建立新的 HtmlTemplate 物件。

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

參數

名稱	類型	說明
blob	BlobSource	要取得 HTML 的物件。

回攻員

HtmlTemplate：新的 HtmlTemplate 物件

擲回

Error：如果 blob 不包含 HTML

---

createTemplate(html)

建立可從指令碼傳回的新 HtmlTemplate 物件。

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

參數

名稱	類型	說明
html	String	範本內容

回攻員

HtmlTemplate：新的 HtmlTemplate 物件

---

createTemplateFromFile(filename)

根據程式碼編輯器中的檔案，建立新的 HtmlTemplate 物件。

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

參數

名稱	類型	說明
filename	String	要使用的檔案名稱

回攻員

HtmlTemplate：新的 HtmlTemplate 物件

擲回

Error：找不到檔案

---

getUserAgent()

取得目前瀏覽器的使用者代理程式字串。針對大部分指令碼傳回 null 如果未用於網頁應用程式的 doGet() 或 doPost() 函式，就會執行。

回攻員

String：使用者代理程式字串