Class HtmlService
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
HtmlService
บริการสำหรับแสดงผล HTML และเนื้อหาข้อความอื่นๆ จากสคริปต์
สคริปต์ไม่สามารถแสดงเนื้อหาต่อเบราว์เซอร์ได้โดยตรงเนื่องจากข้อควรพิจารณาด้านความปลอดภัย แต่ต้องทำให้ HTML ปลอดภัยเพื่อไม่ให้มีการดำเนินการที่เป็นอันตราย ดูคำอธิบายของ
HtmlOutput
เพื่อดูข้อจำกัดเกี่ยวกับสิ่งที่ระบบจะแสดงผล
พร็อพเพอร์ตี้
พร็อพเพอร์ตี้ | ประเภท | คำอธิบาย |
SandboxMode | SandboxMode | อาร์เรย์แบบจำกัดที่แสดงถึงโหมดแซนด์บ็อกซ์ที่ใช้กับHtmlService สคริปต์ฝั่งไคลเอ็นต์ได้ |
XFrameOptionsMode | XFrameOptionsMode | อาร์เรย์แบบจำกัดที่แสดงโหมด X-Frame-Options ที่ใช้กับสคริปต์ HtmlService ฝั่งไคลเอ็นต์ได้ |
เอกสารประกอบโดยละเอียด
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
— หากบล็อกไม่มี 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
— หากบล็อกไม่มี HTML
createTemplate(html)
สร้างออบเจ็กต์ HtmlTemplate
ใหม่ที่สามารถแสดงผลจากสคริปต์
const template = HtmlService.createTemplate(
'<b>The time is <?= new Date() ?></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
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-26 UTC
[null,null,["อัปเดตล่าสุด 2025-07-26 UTC"],[[["\u003cp\u003eHtmlService enables scripts to safely return HTML and other text content to a browser by sanitizing the output to prevent malicious actions.\u003c/p\u003e\n"],["\u003cp\u003eIt offers methods to create HTML output from strings, files, or blobs, and supports templates for dynamic content generation.\u003c/p\u003e\n"],["\u003cp\u003eHtmlService provides control over sandbox modes and \u003ccode\u003eX-Frame-Options\u003c/code\u003e for enhanced security.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize HtmlService to build user interfaces and web applications within Google Apps Script.\u003c/p\u003e\n"]]],["HtmlService allows scripts to return sanitized HTML content to browsers, preventing malicious actions. Key actions include creating `HtmlOutput` objects from strings, `BlobSource` resources, or files via `createHtmlOutput()` and `createHtmlOutputFromFile()`. Similarly, `HtmlTemplate` objects can be created using `createTemplate()` and `createTemplateFromFile()` for dynamic content. The `getUserAgent()` method retrieves the current browser's user-agent string. There are `SandboxMode` and `XFrameOptionsMode` properties that can be used for client-side `HtmlService` scripts.\n"],null,["# Class HtmlService\n\nHtmlService\n\nService for returning HTML and other text content from a script.\n\nDue to security considerations, scripts cannot directly return content to a browser. Instead,\nthey must sanitize the HTML so that it cannot perform malicious actions. See the description of\n[HtmlOutput](/apps-script/reference/html/html-output) for what limitations this implies on what can be returned. \n\n### Properties\n\n| Property | Type | Description |\n|---------------------|-----------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------|\n| `Sandbox``Mode` | [SandboxMode](/apps-script/reference/html/sandbox-mode) | An enum representing the sandbox modes that can be used for client-side `Html``Service` scripts. |\n| `XFrameOptionsMode` | [XFrameOptionsMode](/apps-script/reference/html/x-frame-options-mode) | An enum representing the `X-Frame-Options` modes that can be used for client-side `Html``Service` scripts. |\n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------------------------------|-----------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| [createHtmlOutput()](#createHtmlOutput()) | [HtmlOutput](/apps-script/reference/html/html-output) | Creates a new [HtmlOutput](/apps-script/reference/html/html-output) object that can be returned from the script. |\n| [createHtmlOutput(blob)](#createHtmlOutput(BlobSource)) | [HtmlOutput](/apps-script/reference/html/html-output) | Creates a new [HtmlOutput](/apps-script/reference/html/html-output) object from a [BlobSource](../base/blob-source.html) resource. |\n| [createHtmlOutput(html)](#createHtmlOutput(String)) | [HtmlOutput](/apps-script/reference/html/html-output) | Creates a new [HtmlOutput](/apps-script/reference/html/html-output) object that can be returned from the script. |\n| [createHtmlOutputFromFile(filename)](#createHtmlOutputFromFile(String)) | [HtmlOutput](/apps-script/reference/html/html-output) | Creates a new [HtmlOutput](/apps-script/reference/html/html-output) object from a file in the code editor. |\n| [createTemplate(blob)](#createTemplate(BlobSource)) | [HtmlTemplate](/apps-script/reference/html/html-template) | Creates a new [HtmlTemplate](/apps-script/reference/html/html-template) object from a [BlobSource](../base/blob-source.html) resource. |\n| [createTemplate(html)](#createTemplate(String)) | [HtmlTemplate](/apps-script/reference/html/html-template) | Creates a new [HtmlTemplate](/apps-script/reference/html/html-template) object that can be returned from the script. |\n| [createTemplateFromFile(filename)](#createTemplateFromFile(String)) | [HtmlTemplate](/apps-script/reference/html/html-template) | Creates a new [HtmlTemplate](/apps-script/reference/html/html-template) object from a file in the code editor. |\n| [getUserAgent()](#getUserAgent()) | `String` | Gets the user-agent string for the current browser. |\n\nDetailed documentation\n----------------------\n\n### `create``Html``Output()`\n\nCreates a new [HtmlOutput](/apps-script/reference/html/html-output) object that can be returned from the script.\n\n```javascript\nconst output = HtmlService.createHtmlOutput();\n```\n\n#### Return\n\n\n[HtmlOutput](/apps-script/reference/html/html-output) --- the new HtmlOutput object\n\n*** ** * ** ***\n\n### `create``Html``Output(blob)`\n\nCreates a new [HtmlOutput](/apps-script/reference/html/html-output) object from a [BlobSource](../base/blob-source.html) resource.\n\n```javascript\nfunction createFromBlob(blob) {\n const output = HtmlService.createHtmlOutput(blob);\n return output;\n}\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------------------------------------|-------------------------------|\n| `blob` | [BlobSource](../base/blob-source.html) | the object to get HTML out of |\n\n#### Return\n\n\n[HtmlOutput](/apps-script/reference/html/html-output) --- the new `Html``Output` object\n\n#### Throws\n\n\n[`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) --- if the blob doesn't contain HTML or the HTML is malformed\n\n*** ** * ** ***\n\n### `create``Html``Output(html)`\n\nCreates a new [HtmlOutput](/apps-script/reference/html/html-output) object that can be returned from the script.\n\n```javascript\nconst output = HtmlService.createHtmlOutput('\u003cb\u003eHello world!\u003c/b\u003e');\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|----------------------|\n| `html` | `String` | the content to serve |\n\n#### Return\n\n\n[HtmlOutput](/apps-script/reference/html/html-output) --- the new HtmlOutput object\n\n#### Throws\n\n\n[`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) --- if the html is malformed\n\n*** ** * ** ***\n\n### `create``Html``Output``From``File(filename)`\n\nCreates a new [HtmlOutput](/apps-script/reference/html/html-output) object from a file in the code editor.\n\n```javascript\nconst output = HtmlService.createHtmlOutputFromFile('myPage');\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|------------|----------|-----------------------------|\n| `filename` | `String` | the name of the file to use |\n\n#### Return\n\n\n[HtmlOutput](/apps-script/reference/html/html-output) --- the new `Html``Output` object\n\n#### Throws\n\n\n[`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) --- if the file wasn't found or the HTML in it is malformed\n\n*** ** * ** ***\n\n### `create``Template(blob)`\n\nCreates a new [HtmlTemplate](/apps-script/reference/html/html-template) object from a [BlobSource](../base/blob-source.html) resource.\n\n```javascript\nfunction createFromBlob(blob) {\n const template = HtmlService.createTemplate(blob);\n const output = template.evaluate();\n return output;\n}\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------------------------------------|--------------------------------|\n| `blob` | [BlobSource](../base/blob-source.html) | The object to get HTML out of. |\n\n#### Return\n\n\n[HtmlTemplate](/apps-script/reference/html/html-template) --- the new `Html``Template` object\n\n#### Throws\n\n\n[`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) --- if the blob doesn't contain HTML\n\n*** ** * ** ***\n\n### `create``Template(html)`\n\nCreates a new [HtmlTemplate](/apps-script/reference/html/html-template) object that can be returned from the script.\n\n```javascript\nconst template = HtmlService.createTemplate(\n '\u003cb\u003eThe time is <?= new Date() ?>\u003c/b\u003e',\n);\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|-----------------------------|\n| `html` | `String` | the content of the template |\n\n#### Return\n\n\n[HtmlTemplate](/apps-script/reference/html/html-template) --- the new `Html``Template` object\n\n*** ** * ** ***\n\n### `create``Template``From``File(filename)`\n\nCreates a new [HtmlTemplate](/apps-script/reference/html/html-template) object from a file in the code editor.\n\n```javascript\nconst template = HtmlService.createTemplateFromFile('myTemplate');\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|------------|----------|-----------------------------|\n| `filename` | `String` | the name of the file to use |\n\n#### Return\n\n\n[HtmlTemplate](/apps-script/reference/html/html-template) --- the new `Html``Template` object\n\n#### Throws\n\n\n[`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) --- if the file wasn't found\n\n*** ** * ** ***\n\n### `get``User``Agent()`\n\nGets the user-agent string for the current browser. Returns `null` for most script\nexecutions if not used in a web app's `do``Get()` or `do``Post()` function.\n\n#### Return\n\n\n`String` --- the user-agent string"]]