スクリプトから HTML などのテキスト コンテンツを返すサービス。
セキュリティ上の考慮事項により、スクリプトがブラウザに直接コンテンツを返すことはできません。その代わりに HTML をサニタイズして、悪意のあるアクションを実行できないようにする必要があります。返される結果に関する制限については、HtmlOutput
の説明をご覧ください。
プロパティ
プロパティ | 種類 | 説明 |
---|---|---|
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
- 新しい htmlOutput オブジェクト
createHtmlOutput(blob)
BlobSource
リソースから新しい HtmlOutput
オブジェクトを作成します。
function createFromBlob(blob) { var output = HtmlService.createHtmlOutput(blob); return output; }
パラメータ
名前 | 型 | 説明 |
---|---|---|
blob | BlobSource | 出力するオブジェクトを指定します。 |
リターン
HtmlOutput
- 新しい HtmlOutput
オブジェクト
例外
Error
- blob に HTML が含まれていない場合、または HTML の形式が正しくない
createHtmlOutput(html)
スクリプトから返すことができる新しい HtmlOutput
オブジェクトを作成します。
var output = HtmlService.createHtmlOutput('<b>Hello world!</b>');
パラメータ
名前 | 型 | 説明 |
---|---|---|
html | String | アップロードするコンテンツです |
リターン
HtmlOutput
- 新しい htmlOutput オブジェクト
例外
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 <?= new Date() ?></b>');
パラメータ
名前 | 型 | 説明 |
---|---|---|
html | String | テンプレートのコンテンツ |
リターン
HtmlTemplate
- 新しい HtmlTemplate
オブジェクト
createTemplateFromFile(filename)
コードエディタ内のファイルから新しい HtmlTemplate
オブジェクトを作成します。
var template = HtmlService.createTemplateFromFile('myTemplate');
パラメータ
名前 | 型 | 説明 |
---|---|---|
filename | String | 使用するファイルの名前 |
リターン
HtmlTemplate
- 新しい HtmlTemplate
オブジェクト
例外
Error
- ファイルが見つからない場合
getUserAgent()
現在のブラウザのユーザー エージェント文字列を取得します。ウェブアプリの doGet()
または doPost()
関数で使用されていない場合、ほとんどのスクリプト実行で null
が返されます。
リターン
String
- ユーザー エージェント文字列