Class HtmlOutput

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

페이지에 메타 태그를 추가합니다. Apps Script HTML 파일에 직접 포함된 메타 태그는 무시됩니다. 다음 메타 태그만 허용됩니다.

const output = HtmlService.createHtmlOutput('Hello, world!');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

매개변수

리턴

HtmlOutput: 체이닝을 위한 출력입니다.

이 HtmlOutput의 콘텐츠에 새 콘텐츠를 추가합니다. 이스케이프 처리되지 않으므로 신뢰할 수 있는 소스의 콘텐츠에만 사용하세요.

// Log "Hello, world!
Hello again, world.
"
const output = HtmlService.createHtmlOutput('Hello, world!');
output.append('
Hello again, world.
');
Logger.log(output.getContent());

매개변수

리턴

HtmlOutput: 체이닝을 위한 출력입니다.

생성 값

Error: HTML 형식이 잘못된 경우

참고 항목

• appendUntrusted(addedContent)

문맥 이스케이핑을 사용하여 이 HtmlOutput의 콘텐츠에 새 콘텐츠를 추가합니다.

이 메서드는 HtmlOutput의 현재 상태를 기반으로 콘텐츠를 올바르게 이스케이프 처리하므로 결과는 마크업이나 부작용이 없는 안전한 문자열이 됩니다. 사용자가 제공한 콘텐츠와 같이 신뢰할 수 없는 소스의 콘텐츠를 추가할 때마다 append를 사용하는 대신 이를 사용하면 추가하는 콘텐츠나 마크업이 예기치 않은 코드 실행을 일으키는 교차 사이트 스크립팅 (XSS) 버그가 실수로 허용되는 것을 방지할 수 있습니다.

// Log "Hello, world!<p>Hello again, world.</p>"
const output = HtmlService.createHtmlOutput('Hello, world!');
output.appendUntrusted('
Hello again, world.
');
Logger.log(output.getContent());

매개변수

리턴

HtmlOutput: 체이닝을 위한 출력입니다.

생성 값

Error: HTML 형식이 매우 잘못된 경우

참고 항목

• append(addedContent)

이 HtmlOutput로 지원되는 HtmlTemplate를 반환합니다. 이 메서드는 템플릿을 점진적으로 빌드하는 데 사용할 수 있습니다. 향후 HtmlOutput를 변경하면 HtmlTemplate의 콘텐츠에도 영향을 미칩니다.

const output = HtmlService.createHtmlOutput('Hello, world!');
const template = output.asTemplate();

리턴

HtmlTemplate: 새 HtmlTemplate입니다.

현재 콘텐츠를 지웁니다.

const output = HtmlService.createHtmlOutput('Hello, world!');
output.clear();

리턴

HtmlOutput: 체이닝을 위한 출력입니다.

이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. 이 메서드는 파일 이름에 적절한 확장자(예: 'myfile.pdf')를 추가합니다. 그러나 마지막 마침표 (있는 경우) 뒤에 오는 파일 이름 부분이 대체해야 할 기존 확장 프로그램이라고 가정합니다. 따라서 'ShoppingList.12.25.2014'가 'ShoppingList.12.25.pdf'가 됩니다.

전환의 일일 할당량을 보려면 Google 서비스 할당량을 참고하세요. 새로 생성된 Google Workspace 도메인에는 일시적으로 더 엄격한 할당량이 적용될 수 있습니다.

매개변수

리턴

Blob: 데이터가 blob입니다.

이 객체 내의 데이터를 blob으로 반환합니다.

리턴

Blob: 데이터가 blob입니다.

이 HtmlOutput의 콘텐츠를 가져옵니다.

// Log "Hello, world!"
const output = HtmlService.createHtmlOutput('Hello, world!');
Logger.log(output.getContent());

리턴

String: 게재되는 콘텐츠입니다.

setFaviconUrl(iconUrl)를 호출하여 페이지에 추가된 파비콘 링크 태그의 URL을 가져옵니다. Apps Script HTML 파일에 직접 포함된 favicon 링크 태그는 무시됩니다.

const output = HtmlService.createHtmlOutput('Hello, world!');
output.setFaviconUrl('http://www.example.com/image.png');
Logger.log(output.getFaviconUrl());

리턴

String: 파비콘 이미지의 URL입니다.

Google Docs, Sheets 또는 Forms에서 맞춤 대화상자의 초기 높이를 가져옵니다. HtmlOutput가 웹 앱으로 게시되는 경우 이 메서드는 null를 반환합니다. 이미 열려 있는 대화상자의 크기를 조절하려면 클라이언트 측 코드에서 google.script.host.setHeight(height)를 호출합니다.

const output = HtmlService.createHtmlOutput('Hello, world!');
output.setHeight(200);
Logger.log(output.getHeight());

리턴

Integer: 높이(픽셀)입니다.

addMetaTag(name, content)를 호출하여 페이지에 추가된 메타 태그를 나타내는 객체 배열을 가져옵니다. Apps Script HTML 파일에 직접 포함된 메타 태그는 무시됩니다.

const output = HtmlService.createHtmlOutput('Hello, world!');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

const tags = output.getMetaTags();
Logger.log(
    '',
    tags[0].getName(),
    tags[0].getContent(),
);

리턴

HtmlOutputMetaTag[]: addMetaTag(name, content)를 호출하여 페이지에 추가된 메타 태그를 나타내는 객체 배열입니다.

출력 페이지의 제목을 가져옵니다.