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 オブジェクトを作成します。

const output = HtmlService.createHtmlOutput();

戻る

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

---

createHtmlOutput(blob)

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

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)

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

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

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

戻る

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