Class HtmlService

HtmlService

บริการสำหรับการส่งคืน HTML และเนื้อหาข้อความอื่นๆ จากสคริปต์

สคริปต์ไม่สามารถส่งเนื้อหากลับไปยังเบราว์เซอร์โดยตรงเนื่องจากข้อพิจารณาด้านความปลอดภัย แต่จะต้องทำความสะอาด HTML เพื่อไม่ให้มีการดำเนินการที่เป็นอันตราย ดูข้อจํากัดของ HtmlOutput ที่มีต่อสิ่งที่แสดงได้

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้Typeคำอธิบาย
SandboxModeSandboxModeenum ที่แสดงถึงโหมดแซนด์บ็อกซ์ที่สามารถใช้สำหรับสคริปต์ HtmlService ฝั่งไคลเอ็นต์
XFrameOptionsModeXFrameOptionsModeenum ที่แสดงถึงโหมด X-Frame-Options ที่สามารถใช้สำหรับสคริปต์ HtmlService ฝั่งไคลเอ็นต์ได้

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
createHtmlOutput()HtmlOutputสร้างออบเจ็กต์ HtmlOutput ใหม่ที่สามารถแสดงผลจากสคริปต์
createHtmlOutput(blob)HtmlOutputสร้างออบเจ็กต์ HtmlOutput ใหม่จากทรัพยากร BlobSource
createHtmlOutput(html)HtmlOutputสร้างออบเจ็กต์ HtmlOutput ใหม่ที่สามารถแสดงผลจากสคริปต์
createHtmlOutputFromFile(filename)HtmlOutputสร้างออบเจ็กต์ HtmlOutput ใหม่จากไฟล์ในตัวแก้ไขโค้ด
createTemplate(blob)HtmlTemplateสร้างออบเจ็กต์ HtmlTemplate ใหม่จากทรัพยากร BlobSource
createTemplate(html)HtmlTemplateสร้างออบเจ็กต์ HtmlTemplate ใหม่ที่สามารถแสดงผลจากสคริปต์
createTemplateFromFile(filename)HtmlTemplateสร้างออบเจ็กต์ HtmlTemplate ใหม่จากไฟล์ในตัวแก้ไขโค้ด
getUserAgent()Stringรับสตริง user-agent ของเบราว์เซอร์ปัจจุบัน

เอกสารประกอบโดยละเอียด

createHtmlOutput()

สร้างออบเจ็กต์ HtmlOutput ใหม่ที่สามารถแสดงผลจากสคริปต์

var output = HtmlService.createHtmlOutput();

รีเทิร์น

HtmlOutput — ออบเจ็กต์ HtmlExport ใหม่


createHtmlOutput(blob)

สร้างออบเจ็กต์ HtmlOutput ใหม่จากทรัพยากร BlobSource

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
blobBlobSourceออบเจ็กต์ที่จะเอา HTML ออกจาก

รีเทิร์น

HtmlOutput — ออบเจ็กต์ HtmlOutput ใหม่

การขว้าง

Error — หาก BLOB ไม่มี HTML หรือ HTML มีรูปแบบไม่ถูกต้อง


createHtmlOutput(html)

สร้างออบเจ็กต์ HtmlOutput ใหม่ที่สามารถแสดงผลจากสคริปต์

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
htmlStringเนื้อหาที่จะแสดง

รีเทิร์น

HtmlOutput — ออบเจ็กต์ HtmlExport ใหม่

การขว้าง

Error — หาก HTML มีรูปแบบไม่ถูกต้อง


createHtmlOutputFromFile(filename)

สร้างออบเจ็กต์ HtmlOutput ใหม่จากไฟล์ในตัวแก้ไขโค้ด

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
filenameStringชื่อไฟล์ที่จะใช้

รีเทิร์น

HtmlOutput — ออบเจ็กต์ HtmlOutput ใหม่

การขว้าง

Error — หากไม่พบไฟล์หรือ HTML ในไฟล์มีรูปแบบไม่ถูกต้อง


createTemplate(blob)

สร้างออบเจ็กต์ HtmlTemplate ใหม่จากทรัพยากร BlobSource

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
blobBlobSourceออบเจ็กต์ที่จะดึง HTML ออกมา

รีเทิร์น

HtmlTemplate — ออบเจ็กต์ HtmlTemplate ใหม่

การขว้าง

Error — หาก BLOB ไม่มี HTML


createTemplate(html)

สร้างออบเจ็กต์ HtmlTemplate ใหม่ที่สามารถแสดงผลจากสคริปต์

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
htmlStringเนื้อหาของเทมเพลต

รีเทิร์น

HtmlTemplate — ออบเจ็กต์ HtmlTemplate ใหม่


createTemplateFromFile(filename)

สร้างออบเจ็กต์ HtmlTemplate ใหม่จากไฟล์ในตัวแก้ไขโค้ด

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
filenameStringชื่อไฟล์ที่จะใช้

รีเทิร์น

HtmlTemplate — ออบเจ็กต์ HtmlTemplate ใหม่

การขว้าง

Error — หากไม่พบไฟล์


getUserAgent()

รับสตริง user-agent ของเบราว์เซอร์ปัจจุบัน แสดงผล null สำหรับการดำเนินการสคริปต์ส่วนใหญ่หากไม่ได้ใช้ในฟังก์ชัน doGet() หรือ doPost() ของเว็บแอป

รีเทิร์น

String — สตริง User Agent