Class HtmlService

HtmlService

スクリプトから HTML などのテキスト コンテンツを返すサービス。

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

プロパティ

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

Methods

メソッド戻り値の型概要
createHtmlOutput()HtmlOutputスクリプトから返すことができる新しい HtmlOutput オブジェクトを作成します。
createHtmlOutput(blob)HtmlOutputBlobSource リソースから新しい HtmlOutput オブジェクトを作成します。
createHtmlOutput(html)HtmlOutputスクリプトから返すことができる新しい HtmlOutput オブジェクトを作成します。
createHtmlOutputFromFile(filename)HtmlOutputコードエディタ内のファイルから新しい HtmlOutput オブジェクトを作成します。
createTemplate(blob)HtmlTemplateBlobSource リソースから新しい HtmlTemplate オブジェクトを作成します。
createTemplate(html)HtmlTemplateスクリプトから返すことができる新しい HtmlTemplate オブジェクトを作成します。
createTemplateFromFile(filename)HtmlTemplateコードエディタ内のファイルから新しい HtmlTemplate オブジェクトを作成します。
getUserAgent()String現在のブラウザのユーザー エージェント文字列を取得します。

詳細なドキュメント

createHtmlOutput()

スクリプトから返すことができる新しい HtmlOutput オブジェクトを作成します。

var output = HtmlService.createHtmlOutput();

リターン

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


createHtmlOutput(blob)

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

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

パラメータ

名前説明
blobBlobSource出力するオブジェクトを指定します。

リターン

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

例外

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


createHtmlOutput(html)

スクリプトから返すことができる新しい HtmlOutput オブジェクトを作成します。

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

パラメータ

名前説明
htmlStringアップロードするコンテンツです

リターン

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

例外

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


createHtmlOutputFromFile(filename)

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

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

パラメータ

名前説明
filenameString使用するファイルの名前

リターン

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

例外

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


createTemplate(blob)

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

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

パラメータ

名前説明
blobBlobSourceHTML を取得するオブジェクト。

リターン

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

例外

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


createTemplate(html)

スクリプトから返すことができる新しい HtmlTemplate オブジェクトを作成します。

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

パラメータ

名前説明
htmlStringテンプレートのコンテンツ

リターン

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


createTemplateFromFile(filename)

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

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

パラメータ

名前説明
filenameString使用するファイルの名前

リターン

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

例外

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


getUserAgent()

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

リターン

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