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();

Return

HtmlOutput — 새 HtmlOutput 객체

---

createHtmlOutput(blob)

BlobSource 리소스에서 새 HtmlOutput 객체를 만듭니다.

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

매개변수

이름	유형	설명
blob	BlobSource	HTML을 가져올 객체

Return

HtmlOutput: 새 HtmlOutput 객체

예외 처리

Error — blob에 HTML이 포함되어 있지 않거나 HTML 형식이 잘못된 경우

---

createHtmlOutput(html)

스크립트에서 반환될 수 있는 새 HtmlOutput 객체를 만듭니다.

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

매개변수

이름	유형	설명
html	String	게재할 콘텐츠

Return

HtmlOutput — 새 HtmlOutput 객체

예외 처리

Error — html 형식이 잘못된 경우

---

createHtmlOutputFromFile(filename)

코드 편집기의 파일에서 새 HtmlOutput 객체를 만듭니다.

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

매개변수

이름	유형	설명
filename	String	사용할 파일의 이름

Return

HtmlOutput: 새 HtmlOutput 객체

예외 처리

Error — 파일을 찾을 수 없거나 파일에 포함된 HTML의 형식이 잘못된 경우

---

createTemplate(blob)

BlobSource 리소스에서 새 HtmlTemplate 객체를 만듭니다.

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

매개변수

이름	유형	설명
blob	BlobSource	HTML을 가져올 객체입니다.

Return

HtmlTemplate: 새 HtmlTemplate 객체

예외 처리

Error - blob에 HTML이 포함되지 않은 경우

---

createTemplate(html)

스크립트에서 반환될 수 있는 새 HtmlTemplate 객체를 만듭니다.

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

매개변수

이름	유형	설명
html	String	템플릿 콘텐츠

Return

HtmlTemplate: 새 HtmlTemplate 객체

---

createTemplateFromFile(filename)

코드 편집기의 파일에서 새 HtmlTemplate 객체를 만듭니다.

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

매개변수

이름	유형	설명
filename	String	사용할 파일의 이름

Return

HtmlTemplate: 새 HtmlTemplate 객체

예외 처리

Error: 파일을 찾을 수 없는 경우

---

getUserAgent()

현재 브라우저의 사용자 에이전트 문자열을 가져옵니다. 웹 앱의 doGet() 또는 doPost() 함수에서 사용되지 않으면 대부분의 스크립트 실행에 null를 반환합니다.

Return

String — 사용자 에이전트 문자열