Class HtmlService

HtmlService

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

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

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

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
SandboxMode	SandboxMode	การแจงนับที่แสดงโหมดแซนด์บ็อกซ์ที่ใช้กับสคริปต์ฝั่งไคลเอ็นต์ HtmlService ได้
XFrameOptionsMode	XFrameOptionsMode	การแจงนับที่แสดงถึง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 ใหม่ที่ส่งคืนจากสคริปต์ได้

const output = HtmlService.createHtmlOutput();

รีเทิร์น

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

---

createHtmlOutput(blob)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
blob	BlobSource	ออบเจ็กต์ที่จะรับ HTML จาก

รีเทิร์น

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

ส่ง

Error — หาก Blob ไม่มี HTML หรือ HTML ผิดรูปแบบ

---

createHtmlOutput(html)

สร้างออบเจ็กต์ HtmlOutput ใหม่ที่ส่งคืนจากสคริปต์ได้

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
html	String	เนื้อหาที่จะแสดง

รีเทิร์น

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

ส่ง

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

---

createHtmlOutputFromFile(filename)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
filename	String	ชื่อไฟล์ที่จะใช้

รีเทิร์น

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

ส่ง

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

---

createTemplate(blob)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
blob	BlobSource	ออบเจ็กต์ที่จะรับ HTML จาก

รีเทิร์น

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

ส่ง

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

---

createTemplate(html)

สร้างออบเจ็กต์ HtmlTemplate ใหม่ที่ส่งคืนจากสคริปต์ได้

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
html	String	เนื้อหาของเทมเพลต

รีเทิร์น

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

---

createTemplateFromFile(filename)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
filename	String	ชื่อไฟล์ที่จะใช้

รีเทิร์น

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

ส่ง

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

---

getUserAgent()

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

รีเทิร์น

String - สตริง User Agent