Class HtmlService

HTMLService

スクリプトから HTML とその他のテキスト コンテンツを返すためのサービス。

セキュリティ上の理由から、スクリプトを使用してコンテンツをブラウザに直接返すことはできません。その代わりに、HTML をサニタイズして悪意のあるアクションを実行できないようにする必要があります。返された内容に関する制限については、HtmlOutput の説明をご覧ください。

Properties

プロパティ	種類	説明
SandboxMode	SandboxMode	クライアント側の HtmlService スクリプトに使用できるサンドボックス モードを表す列挙型。
XFrameOptionsMode	XFrameOptionsMode	クライアント側の HtmlService スクリプトに使用できる X-Frame-Options モードを表す列挙型。

Methods

方法	戻り値の型	概要
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();

戻る

HtmlOutput - 新しい MetadataOutput オブジェクト

---

createHtmlOutput(blob)

BlobSource リソースから新しい HtmlOutput オブジェクトを作成します。

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

パラメータ

名前	型	説明
blob	BlobSource	HTML の取得に使用するオブジェクト

戻る

HtmlOutput - 新しい HtmlOutput オブジェクト。

スロー値

Error - blob に HTML が含まれていないか、HTML の形式が正しくない場合

---

createHtmlOutput(html)

スクリプトから返す新しい HtmlOutput オブジェクトを作成します。

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

パラメータ

名前	型	説明
html	String	配信するコンテンツ

戻る

HtmlOutput - 新しい MetadataOutput オブジェクト

スロー値

Error - HTML の形式が正しくない場合

---

createHtmlOutputFromFile(filename)

コードエディタのファイルから新しい HtmlOutput オブジェクトを作成します。

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

パラメータ

名前	型	説明
filename	String	使用するファイルの名前

戻る

HtmlOutput - 新しい HtmlOutput オブジェクト。

スロー値

Error - ファイルが見つからないか、ファイル内の HTML の形式が正しくない

---

createTemplate(blob)

BlobSource リソースから新しい HtmlTemplate オブジェクトを作成します。

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

パラメータ

名前	型	説明
blob	BlobSource	HTML の取得に使用するオブジェクト。

戻る

HtmlTemplate - 新しい HtmlTemplate オブジェクト。

スロー値

Error - blob に HTML が含まれていない場合

---

createTemplate(html)

スクリプトから返す新しい HtmlTemplate オブジェクトを作成します。

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

パラメータ

名前	型	説明
html	String	テンプレートのコンテンツ

戻る

HtmlTemplate - 新しい HtmlTemplate オブジェクト。

---

createTemplateFromFile(filename)

コードエディタのファイルから新しい HtmlTemplate オブジェクトを作成します。

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

パラメータ

名前	型	説明
filename	String	使用するファイルの名前

戻る

HtmlTemplate - 新しい HtmlTemplate オブジェクト。

スロー値

Error - ファイルが見つからない場合は、

---

getUserAgent()

現在のブラウザのユーザー エージェント文字列を取得します。ウェブアプリの doGet() 関数または doPost() 関数で使用されない場合、ほとんどのスクリプト実行に対して null を返します。

戻る

String - ユーザー エージェント文字列