【GAS入門#83】HTMLファイルから本格Web画面を描画!HtmlService.createHtmlOutputFromFile()の使い方とダッシュボード画面の作成

前回(第82回)は、GASからHTMLを直接出力してブラウザにWebページを表示させる HtmlService.createHtmlOutput() の使い方を学び、緊急時やメンテナンス時に役立つ「システムメンテナンス案内画面」を作成しましたね!

前回のコードを書いてみて、こんなふうに感じませんでしたか?
「たしかにWeb画面は出せたけれど、JavaScript(.gs)のコードの中に何十行もHTMLやCSSを文字列として書くのって、正直めちゃくちゃ書きづらい……」
「クォーテーションの囲みミスで構文エラーになったり、インデントが崩れてどこが何のタグかわからなくなったりする……」

その感覚、大正解です!
実務で使うようなモダンな社内ポータルやダッシュボード画面は、ボタン、グラフ表示枠、KPIカード、ナビゲーションバーなど、HTML・CSSの行数が数百行から千行を超えることも珍しくありません。それをすべて .gs ファイルの中に文字列で詰め込むのは、保守の面でも作業効率の面でも限界があります。

そこで第83回となる今回は、GASのエディタ内に独立した「HTMLファイル」を新しく作成し、そのファイルを読み込んで美しいWeb画面を描画する超重要メソッド HtmlService.createHtmlOutputFromFile() を徹底解説します!

「札幌オフィス統合ダッシュボード」のメイン画面を題材に、カードUIやサイドバーが整ったモダンなダッシュボード画面を構築しながら、ファイル作成の手順、コードの役割分担、実務で必須となるCSSファイル分割のプロ技、そして初心者が100%ハマる落とし穴まで、手取り足取りどこよりも分かりやすくお届けします!

1. そもそも HtmlService.createHtmlOutputFromFile() とは?

まずは、今回新しく覚える命令の文法と、なぜこのメソッドが必要なのかを整理しましょう。

HtmlService.createHtmlOutputFromFile() は、GASプロジェクト内に作成した HTMLファイル(拡張子が .html のファイル)をファイル名で指定して読み込み、ブラウザで表示可能なWebページ(HtmlOutputオブジェクト)として出力する命令 です。

基本コードの構文

function doGet(e) {
// 'index' という名前のHTMLファイルを読み込んでブラウザに表示する
return HtmlService.createHtmlOutputFromFile('index');
}

引数のカッコの中には、読み込みたいHTMLファイルの「ファイル名」を文字列で指定します。
※ここで最大のポイントは、末尾の拡張子 .html を書かずに、ファイル名だけを渡す点です(例:’index.html’ ではなく ‘index’)。 これについては後ほど詳しく解説しますね!

createHtmlOutput と createHtmlOutputFromFile の違いを徹底比較!

第82回で学んだ createHtmlOutput() と、今回の createHtmlOutputFromFile() の違いを表で整理しておきましょう。

比較項目 createHtmlOutput()(第82回) createHtmlOutputFromFile()(今回:第83回)★
HTMLの書き場所 .gs ファイルの中に文字列で直書き 独立した .html ファイルの中に書く
引数に渡すもの HTMLコードそのものの文字列 HTMLファイルの「ファイル名(例: ‘index’)」
エディタの入力補完 効かない(単なる文字扱い) HTML/CSS用のシンタックスハイライト・補完が効く!
コードの読みやすさ 長くなると地獄のように見づらい デザインとプログラムが分離されてスッキリ!
主な活躍シーン 数行のメッセージ、緊急メンテナンス告知 ダッシュボード、業務フォーム、本格Webアプリ

「設計図」と「現場監督」の例えでイメージしよう!

プログラミングの世界では、「プログラムの処理(ロジック)」と「画面の見た目(デザイン)」を別々の場所に分けて管理することを 「関心の分離」 と呼びます。

  • Code.gs(現場監督・司令塔)
    ユーザーからリクエストが来たらデータを用意し、「あの設計図を元に部屋を組み立てて!」と指示を出す司令塔。
  • index.html(設計図・インテリアデザイン)
    壁の色、ボタンの配置、文字の大きさなど、見た目(HTML/CSS)だけを美しく整えた設計図。

現場監督の指示書の中にインテリアの壁紙まで全部手書きするのではなく、専用の設計図(index.html)を別に用意して、現場監督(Code.gs)が「createHtmlOutputFromFile('index') であの設計図を広げてブラウザに届けてね!」と指示を出すほうが、誰が見ても分かりやすく、作業分担もスムーズになりますよね。

2. STEP1:準備!GASエディタに「HTMLファイル」を新規作成しよう

それでは、実際に手を動かして新しいHTMLファイルをプロジェクト内に追加していきましょう!
今回は、第81回・第82回で使用した「札幌オフィス統合管理簿」のスプレッドシートを引き続き活用します。

HTMLファイル作成の4ステップ手順

1. スプレッドシートからApps Scriptエディタを開く
Googleスプレッドシート「札幌オフィス統合管理簿」を開き、上部メニューバーの 「拡張機能」 > 「Apps Script」 をクリックします。

2. 「ファイルを追加」ボタンを押す
エディタ画面の左側にある「ファイル」一覧の横にある 「+(ファイルを追加)」 アイコン をクリックします。

3. 「HTML」を選択する
メニューが表示されたら、「HTML」 を選択します。

4. ファイル名を入力する
入力欄が表示されたら、半角英数で index と入力して Enterキー を押します。
※このとき、index.html と打つ必要はありません。index と打つだけで、自動的に .html 形式のファイルとして作成されます。

左側のファイル一覧に、従来の コード.gs の下に index.html が並んで表示されていれば、準備は完璧です!

3. STEP2:【実践】モダンな「札幌オフィス統合ダッシュボード」画面を作ろう!

準備ができたら、さっそく index.html の中にダッシュボードの画面をデザインしていきましょう!
今回は、札幌オフィスのスタッフが朝出社した際や、リモートワーク開始時にパッと見て業務状況が把握できるように、以下の要素を盛り込んだモダンなUIを構築します。

  • ヘッダー&ナビゲーション:爽やかなネイビー×アクセントオレンジの札幌IT企業スタイル
  • KPIハイライトカード:売上目標達成率(120%達成!)、当月来店数、稼働プロジェクト数
  • オフィスリアルタイム状況:札幌第1会議室の予約状況、本日のセコマ買い出し当番メモ
  • 札幌ローカルインフォ:チカホ(地下歩行空間)直結ビルの快適アナウンスや天候メモ

index.html のコードを入力する

左側のファイル一覧から index.html をクリックして開き、元々入っているコードをすべて消去して、以下のコードをそのままコピー&ペーストしてください。

<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- Google Apps ScriptのWebアプリでリンクやフォームを正常動作させるための必須タグ -->
<base target="_top">
<title>札幌オフィス統合ダッシュボード</title>
<style>
/* --- 基本スタイル & リセット --- */
* {
box-sizing: border-box;
margin: 0;
padding: 0;
}
body {
font-family: "Helvetica Neue", Arial, "Hiragino Kaku Gothic ProN", "BIZ UDPGothic", sans-serif;
background-color: #f4f7f6;
color: #2d3748;
display: flex;
min-height: 100vh;
}

/* --- 左側サイドバー --- */
.sidebar {
width: 240px;
background-color: #1a365d; /* 深みのある札幌ネイビー */
color: #ffffff;
padding: 24px 16px;
display: flex;
flex-direction: column;
}
.sidebar h2 {
font-size: 16px;
font-weight: 700;
letter-spacing: 0.05em;
margin-bottom: 32px;
display: flex;
align-items: center;
gap: 8px;
}
.nav-menu {
list-style: none;
}
.nav-item {
margin-bottom: 8px;
}
.nav-link {
display: block;
padding: 10px 14px;
color: #cbd5e0;
text-decoration: none;
border-radius: 6px;
font-size: 14px;
font-weight: 500;
transition: all 0.2s;
}
.nav-link:hover, .nav-link.active {
background-color: #2b6cb0;
color: #ffffff;
}

/* --- メインコンテンツ領域 --- */
.main-content {
flex: 1;
padding: 32px;
overflow-y: auto;
}
.header {
display: flex;
justify-content: space-between;
align-items: center;
margin-bottom: 28px;
}
.header h1 {
font-size: 24px;
font-weight: 700;
color: #1a202c;
}
.badge-status {
background-color: #c6f6d5;
color: #22543d;
padding: 6px 14px;
border-radius: 20px;
font-size: 12px;
font-weight: 700;
}

/* --- KPIカード グリッドレイアウト --- */
.kpi-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
gap: 20px;
margin-bottom: 32px;
}
.kpi-card {
background-color: #ffffff;
padding: 20px;
border-radius: 10px;
box-shadow: 0 4px 6px rgba(0, 0, 0, 0.04);
border-left: 4px solid #3182ce;
}
.kpi-card.highlight {
border-left-color: #dd6b20; /* 札幌オレンジ */
}
.kpi-title {
font-size: 13px;
color: #718096;
font-weight: 600;
margin-bottom: 8px;
}
.kpi-value {
font-size: 28px;
font-weight: 700;
color: #1a202c;
}
.kpi-sub {
font-size: 12px;
color: #38a169;
margin-top: 4px;
font-weight: 600;
}

/* --- 2カラム ウィジェットエリア --- */
.dashboard-grid {
display: grid;
grid-template-columns: 2fr 1fr;
gap: 24px;
}
.widget-panel {
background-color: #ffffff;
padding: 24px;
border-radius: 10px;
box-shadow: 0 4px 6px rgba(0, 0, 0, 0.04);
}
.widget-panel h3 {
font-size: 16px;
font-weight: 700;
margin-bottom: 16px;
color: #2d3748;
border-bottom: 2px solid #edf2f7;
padding-bottom: 8px;
}
.room-status-item {
display: flex;
justify-content: space-between;
align-items: center;
padding: 12px 0;
border-bottom: 1px solid #edf2f7;
}
.room-status-item:last-child {
border-bottom: none;
}
.room-name {
font-weight: 600;
font-size: 14px;
}
.room-badge {
font-size: 11px;
padding: 4px 10px;
border-radius: 12px;
font-weight: 700;
}
.badge-inuse {
background-color: #fed7d7;
color: #9b2c2c;
}
.badge-available {
background-color: #feebc8;
color: #7b341e;
}
.info-list {
list-style: none;
font-size: 13px;
line-height: 1.8;
color: #4a5568;
}
.info-list li {
margin-bottom: 8px;
}

/* レスポンシブ対応 */
@media (max-width: 768px) {
body {
flex-direction: column;
}
.sidebar {
width: 100%;
padding: 16px;
}
.dashboard-grid {
grid-template-columns: 1fr;
}
}
</style>
</head>
<body>
<!-- 左側サイドバー -->
<aside class="sidebar">
<h2>🏢 札幌オフィス DX</h2>
<ul class="nav-menu">
<li class="nav-item"><a href="#" class="nav-link active">📊 メインダッシュボード</a></li>
<li class="nav-item"><a href="#" class="nav-link">📅 会議室予約管理</a></li>
<li class="nav-item"><a href="#" class="nav-link">📑 請求・業績データ</a></li>
<li class="nav-item"><a href="#" class="nav-link">⚙️ システム環境設定</a></li>
</ul>
</aside>

<!-- 右側メインコンテンツ -->
<main class="main-content">
<div class="header">
<div>
<h1>統合業務ダッシュボード</h1>
<p style="font-size: 13px; color: #718096; margin-top: 4px;">札幌オフィス リアルタイム稼働モニター</p>
</div>
<div class="badge-status">● 全システム正常稼働中</div>
</div>

<!-- KPIハイライトカード -->
<div class="kpi-grid">
<div class="kpi-card highlight">
<div class="kpi-title">当月売上目標達成率</div>
<div class="kpi-value">120.4%</div>
<div class="kpi-sub">▲ 前年同月比 +15.2%</div>
</div>
<div class="kpi-card">
<div class="kpi-title">今月の来店・来客予定</div>
<div class="kpi-value">48 件</div>
<div class="kpi-sub" style="color:#3182ce;">● 本日予定:4件</div>
</div>
<div class="kpi-card">
<div class="kpi-title">稼働中DXプロジェクト</div>
<div class="kpi-value">12 件</div>
<div class="kpi-sub">全案件オンスケジュール</div>
</div>
<div class="kpi-card">
<div class="kpi-title">残業削減率(前月比)</div>
<div class="kpi-value">-18.5%</div>
<div class="kpi-sub">GAS自動化推進の成果</div>
</div>
</div>

<!-- 2カラムウィジェットエリア -->
<div class="dashboard-grid">
<div class="widget-panel">
<h3>🕒 札幌オフィス 施設・会議室リアルタイム予約</h3>
<div class="room-status-item">
<div>
<div class="room-name">第1会議室(テレビ会議ブース)</div>
<div style="font-size: 12px; color: #718096;">13:00 - 14:30 【東京・札幌合同定例ミーティング】</div>
</div>
<span class="room-badge badge-inuse">利用中(〜14:30)</span>
</div>
<div class="room-status-item">
<div>
<div class="room-name">第2ミーティングスペース</div>
<div style="font-size: 12px; color: #718096;">15:00 - 16:00 【秋のスープカレー企画打ち合わせ】</div>
</div>
<span class="room-badge badge-available">空室(15:00〜予約あり)</span>
</div>
<div class="room-status-item">
<div>
<div class="room-name">集中作業ポッド(1人席)</div>
<div style="font-size: 12px; color: #718096;">終日フリー利用可能</div>
</div>
<span class="room-badge badge-available" style="background-color:#c6f6d5; color:#22543d;">即時利用可</span>
</div>
</div>

<div class="widget-panel">
<h3>📢 オフィス内アナウンス</h3>
<ul class="info-list">
<li><strong>🏪 本日のセコマ当番:</strong><br>高橋エンジニア(15時頃出動予定)</li>
<li><strong>🚇 交通・チカホ情報:</strong><br>地下鉄各線・JR快速エアポートともに平常運行中。</li>
<li><strong>💡 今週の標語:</strong><br>「手作業を減らして、定時でサクッと美味しいご飯を食べよう!」</li>
</ul>
</div>
</div>
</main>
</body>
</html>

貼り付けたら、エディタ上部の 「保存アイコン(フロッピーディスクのマーク)」 をクリックして保存します。

4. STEP3:【実践】GASからHTMLを呼び出してWebアプリを表示しよう!

HTMLの準備が整ったので、次は コード.gs 側からこの index.html を呼び出すスクリプトを書いていきましょう!

1. コード.gs に呼び出し関数を記述する

左側のファイル一覧から コード.gs を選択し、エディタの中身を以下のように書き換えてください。

/**
* 札幌オフィス統合ダッシュボード Webアプリケーション
* ブラウザからGETリクエストが届いた時に自動起動する関数
*/
function doGet(e) {
// ① HTMLファイル(index.html)から出力オブジェクトを作成する
var htmlOutput = HtmlService.createHtmlOutputFromFile('index');

// ② ブラウザのタブに表示されるタイトルを設定する(第86回で詳しく解説!)
htmlOutput.setTitle('札幌オフィス統合管理ダッシュボード');

// ③ スマホ等の画面サイズに最適化するメタタグを追加する
htmlOutput.addMetaTag('viewport', 'width=device-width, initial-scale=1');

// ④ 完成したWeb画面をブラウザへ返す
return htmlOutput;
}

2. コードを1行ずつ徹底解説!

  • HtmlService.createHtmlOutputFromFile('index')
    本日の主役です!先ほど作成した index.html を読み込んで、HTML画面のオブジェクトを作成しています。引数には .html をつけず、'index' とだけ書くのがルールです。
  • htmlOutput.setTitle('札幌オフィス統合管理ダッシュボード')
    作成した画面オブジェクトに対して .setTitle() を呼び出すと、ブラウザのタブに表示されるページ名を変更できます。これを入れるだけで一気にプロ仕様の社内システムらしくなります!
  • htmlOutput.addMetaTag('viewport', 'width=device-width, initial-scale=1')
    モバイル端末(スマートフォンやiPad)でアクセスした際に、画面の横幅を端末に合わせて自動調整してくれるお約束の設定です。

3. 保存して開発用テストURL(/dev)で表示確認しよう!

コードが保存できたら、第81回・第82回でお伝えした 「テスト用URL(/dev)」 を使って、ブラウザで表示を確認してみましょう!

  1. エディタ画面右上の青い 「デプロイ」 > 「デプロイをテスト」 をクリックします。
  2. 表示されたダイアログ内の 「ウェブアプリのURL」(末尾が /dev になっているURL)をコピーします。
  3. ブラウザの新しいタブに貼り付けて開いてみてください!

【実行結果の確認】

どうでしょうか!?
左側に落ち着いたネイビーのサイドバーが並び、右側には「売上目標達成率 120.4%」のカードや会議室の空き状況、セコマ当番メモが美しくレイアウトされたモダンなダッシュボード画面が表示されたはずです!

第82回の「文字列直書き」と比べると、エディタ側の コード.gs はたった数行で超スッキリ保たれ、HTMLとCSSは index.html の中で綺麗に色分けされて編集できるため、今後の修正や機能追加も圧倒的にやりやすくなりました!

5. STEP4:実務で差がつく!「CSS・JavaScriptのファイル分割(インクルード機能)」完全マスター

ここまでの手順で十分に綺麗な画面が作れましたが、現場で大規模なシステムを構築していると、さらに次のような壁にぶつかります。

  • 「CSSのデザインコードだけで300行を超えてしまい、HTMLの骨組み(タグ)が見えにくくなってきた……」
  • 「画面上のボタンをクリックした時のJavaScript処理も別のファイルに分けてスッキリさせたい!」

通常のWeb制作では <link rel="stylesheet" href="style.css"> のように外部ファイルを読み込みますが、GASのWebアプリ環境ではローカルの style.css を直接リンクタグで読み込むことができません。

そこでプロのエンジニアが現場で100%実践しているのが、「インクルード関数(部品合体テクニック)」 です!これを知っておくだけで、社内でも「お、この人のコードはめちゃくちゃ綺麗で設計がしっかりしているな!」と一目置かれるようになりますよ。

インクルード機能の仕組み(3つのファイル構成)

  • index.html:HTMLの枠組み(骨組み)だけを書く
  • stylesheet.html:CSS(デザイン装飾)だけを書く
  • javascript.html:ブラウザ側で動くJS(動き)だけを書く
  • コード.gs:部品を合体させる魔法の関数 include() を用意する

実装手順

1. stylesheet.html を新しく作成する
左側のファイル追加「+」>「HTML」をクリックし、ファイル名を stylesheet にします。
中身を以下のように <style> タグで囲んだCSSだけの状態にします。

<!-- stylesheet.html -->
<style>
body {
font-family: sans-serif;
background-color: #f4f7f6;
}
.highlight-text {
color: #dd6b20;
font-weight: bold;
}
</style>

2. コード.gs にインクルード用の関数を追加する
コード.gs の末尾に、以下の短い関数を追加します。

/**
* 指定したHTMLファイルの中身をテキストとして読み込む共通関数
*/
function include(filename) {
return HtmlService.createHtmlOutputFromFile(filename).getContent();
}

※ .getContent() は、読み込んだHTMLファイルの中身を「生の文字列(テキスト)」として取り出す便利な命令です。

3. index.html 側から呼び出す
次回(第84回)で本格的に学ぶテンプレート構文 <?!= include('ファイル名'); ?> を使って、index.html の <head> 内にCSSを差し込みます。

<head>
<base target="_top">
<!-- ここで stylesheet.html の中身を自動合体! -->
<?!= include('stylesheet'); ?>
</head>

このようにファイルを分割できるようになると、HTMLはHTML、CSSはCSSと綺麗に棲み分けができ、何千行規模の大規模なWebダッシュボードでもストレスなく快適に開発できるようになります!

6. 初心者が絶対につまずく!5大トラップと完全対処法

createHtmlOutputFromFile() を使い始めた方が非常によく直面する「5つの落とし穴」と、その完全な解決策をまとめました。エラーで画面が出なくなったときは、焦らずここを順番に見直してみてくださいね!

トラップ1:引数に「.html」まで書いてしまって No item with the given name could be found と叱られる

初心者事故率No.1のミスです!

// ✕ エラーになる書き方(.html を付けてしまっている)
var output = HtmlService.createHtmlOutputFromFile('index.html');

// ◯ 正しい書き方(拡張子なしでファイル名だけを指定する)
var output = HtmlService.createHtmlOutputFromFile('index');

【原因と対策】
エディタの画面では index.html と見えているため、ついつい 'index.html' と書きたくなりますが、GASの createHtmlOutputFromFile() は 「拡張子を抜いた名前」 を渡すルールになっています。必ず 'index' とだけ書きましょう!

トラップ2:ファイル名の大文字・小文字、アンダースコアの不一致

左側のファイル名が Index.html(先頭が大文字)になっているのに、コードで 'index'(小文字)と指定していると、GASは「そんなファイルは存在しません」とエラーを出します。
ファイル名とコード内の文字列は、大文字・小文字も含めて完全に一致させてください。

トラップ3:<base target=”_top”> を書き忘れて画面遷移でブロックされる

HTML内の <head> タグの中に <base target="_top"> を入れ忘れると、ページ内のリンク(<a href="...">)をクリックしたりフォームを送信したときに、Googleのセキュリティ(iframeの制限)に引っかかり、「ページの読み込みがブロックされました」と表示されて動かなくなってしまいます。
GASでHTMLファイルを作る際は、「<head> の先頭には必ず <base target="_top"> を書く!」 と合言葉のように覚えておきましょう!

トラップ4:本番URL(/exec)でリロードしても画面が変わらない

第81回でも触れましたが、index.html の見た目を変えて保存したあと、末尾が /exec の本番公開URLをブラウザでリロードしても、画面は古いまま変化しません。

【解決策】

  • 開発中の見た目チェックは、保存するだけで即座に反映される テスト用URL(末尾が /dev) を使う!
  • 同僚などに共有している本番URL(/exec)を更新したい時は、必ず 「デプロイ」 > 「デプロイを管理」 > 編集(鉛筆マーク) > 「バージョン: 新規バージョン」 を選んでデプロイボタンを押してください。

トラップ5:複数アカウントでログインしていて「アクセスが拒否されました」となる

1つのChromeブラウザで「個人のGmail」と「会社のGoogle Workspace」など複数のアカウントにログインしていると、GASのWebアプリを開いたときにGoogleドライブ側の認証が干渉し、画面が表示されずに真っ白になったりアクセス拒否エラーが出ることがあります。
Webアプリの動作テストを行う際は、「シークレットウィンドウ(プライベートブラウズ)」 でテスト用URLを開くのが一番確実で安全です!

7. 今回のまとめ&次回予告

今回は、Google Apps Scriptで独立したHTMLファイルを読み込み、本格的なダッシュボード画面を描画する HtmlService.createHtmlOutputFromFile() の使い方を詳しく解説しました!

本日の重要ポイントをもう一度おさらいしておきましょう。

  1. createHtmlOutputFromFile('ファイル名') で、プロジェクト内の .html ファイルを読み込んで描画できる!
  2. 引数には拡張子 .html を含めず、ファイル名だけ(例: 'index') を渡すのが鉄則。
  3. プログラムの処理(Code.gs)とデザイン(index.html)を分離することで、コードが劇的に見やすく保守しやすくなる!
  4. リンクのクリックや画面遷移を正常に動かすため、<head> 内に <base target="_top"> を必ず記述する。
  5. 開発テスト中は、デプロイ更新の手間が省ける テスト用URL(/dev) を活用する!

これで、デザインされた本格的なWebサイトや社内ダッシュボードの「外観(UI)」を自由自在に作れるようになりましたね!

🚀 次回予告:いよいよスプレッドシートの生データを画面に埋め込む!
今回のダッシュボード画面に表示されている「達成率120.4%」や「会議室の予約状況」は、まだHTMLに固定で書いたダミーの文字でしたよね。
実務では、「スプレッドシートに入力された本日の最新データや計算結果を、画面を開いた瞬間にリアルタイムで自動反映させたい!」 はずです。

そこで次回(第84回)は、GASとHTMLの間でリアルタイムなデータ連携を可能にする HtmlService.createTemplateFromFile() を解説します!
スプレッドシートをデータベースにして動的に変化する本格ダッシュボードを完成させていきますので、ぜひ次回もお楽しみに!