【GAS入門#82】HTMLでWeb画面を表示!HtmlService.createHtmlOutput()の使い方とシステムメンテナンス画面の作成

前回(第81回)は、GASでWebアプリケーションを構築するためのすべての入口となる基本関数 doGet(e) の仕組みと、インターネット上に公開するための「デプロイ」手順を学びましたね!

前回は動作確認として、ContentService.createTextOutput() を使ってシンプルな「文字(プレーンテキスト)」を画面に表示させました。
しかし、本物のWebアプリケーションや社内ポータルを作るなら、文字だけでなく、色鮮やかなデザイン、見出し、枠線、ボタンなどが整った「本物のWebページ(HTML画面)」を表示させたいですよね!

そこで第82回となる今回は、Google Apps ScriptからHTMLコードを直接ブラウザへ出力し、リッチなWeb画面を描画する超重要メソッド HtmlService.createHtmlOutput() を徹底解説します!

今回は、札幌オフィスの全メンバーが利用する「札幌オフィス統合ダッシュボード」のシステム改修時に役立つ、スタイリッシュな「システムメンテナンス案内画面」 の作成を題材にします。

HTMLやCSSの知識に自信がない初心者の方でも、コピペでそのまま動かせる完成度の高いサンプルコードを用意しました。仕組みの解説から実務での応用テクニック、初心者が必ず直面するトラブルシューティングまで、どこよりも分かりやすくお届けします!

1. そもそも HtmlService.createHtmlOutput() とは?Web画面描画の基本

まずは、今回新しく登場する HtmlService と createHtmlOutput() の正体を解き明かしていきましょう。

コードの構造を分解してみよう

プログラミングの世界では、ドット(.)で区切って「誰が(対象・クラス)」と「何をする(命令・メソッド)」を指定します。

var htmlOutput = HtmlService.createHtmlOutput("<h1>こんにちは!</h1>");
  • HtmlService(エイチティーエムエル・サービス)
    Google Apps ScriptでHTMLやWeb画面を扱うための機能を一手に管理している「親玉(サービス)」です。スプレッドシートの SpreadsheetApp やGmailの GmailApp と同じ仲間の存在で、「今からWeb画面の生成・操作を行うよ!」と宣言する役割を果たします。
  • .createHtmlOutput(“HTML文字列”)(クリエイト・エイチティーエムエル・アウトプット)
    HtmlService という親玉に対する命令(メソッド)です。カッコの中に渡したHTMLの文字列をもとに、ブラウザが表示可能なWebページデータ(HtmlOutput オブジェクト)を瞬時に組み立ててくれます。

「白黒のメモ帳」から「カラーのデザインポスター」へ

前回(第81回)で使った ContentService.createTextOutput() と、今回の HtmlService.createHtmlOutput() の違いをイメージで整理してみましょう。

  • ContentService.createTextOutput()(前回)
    例えるなら、白い紙に黒いボールペンだけで書いた 「単なるメモ書き」 です。文字情報は伝わりますが、文字の大きさを変えたり、背景に色を塗ったり、ボタンを配置したりすることはできません。
  • HtmlService.createHtmlOutput()(今回)
    例えるなら、写真やイラスト、鮮やかなフォントでデザインされた 「カラーの案内ポスター(Webページ)」 です。HTMLやCSSの力を自由に使えるため、モダンでおしゃれな画面をユーザーに届けることができます。

Webアプリとして画面が表示されるまでの流れ

ブラウザからアクセスされた時、GASの裏側では以下の3つのステップが高速で実行されています。

  1. ユーザーがWebアプリのURLをブラウザで開く(GETリクエスト送信)
  2. Googleサーバーが検知し、GASの doGet(e) 関数を自動起動する
  3. doGet(e) の中で HtmlService.createHtmlOutput() を使ってHTMLを組み立て、return(返却)する
  4. ユーザーのブラウザ画面に、デザインされた美しいWebページが表示される!

このように、doGet(e) の出口(戻り値)として createHtmlOutput() で作ったデータを渡してあげるのが、GASでWebアプリを作る際の絶対的な基本ルールとなります。

2. createHtmlOutput() と createHtmlOutputFromFile() の違いと使い分け

GASでHTML画面を表示させる命令には、今回学ぶ createHtmlOutput() のほかに、次回(第83回)で学ぶ createHtmlOutputFromFile() という非常に似た名前の命令が存在します。

この2つの違いをあらかじめ知っておくと、今後の開発で迷うことがなくなります!

2つのHTML生成メソッド比較表

比較項目HtmlService.createHtmlOutput()(★今回)HtmlService.createHtmlOutputFromFile()(次回)
HTMLの書き場所.gs コード内に文字列として直接書く別途作成した .html ファイルの中に書く
引数に渡すものHTMLコードそのものの文字列読み込みたいHTMLファイルの「ファイル名」
ファイル構成.gs ファイル1つだけで完結する.gs と .html の2つのファイルが必要
主なメリット手軽、短文や簡易画面なら一瞬で作れるコードが見やすく、長文や本格的なUIに向いている
主な用途メンテナンス画面、簡易完了メッセージ、エラー画面ダッシュボード本体、複雑な業務入力フォーム

なぜ「メンテナンス画面」には createHtmlOutput() が最適なのか?

本格的なダッシュボード画面は何百行ものHTML/CSSを書くため別ファイル(.html)に分けた方が管理しやすいですが、今回の「システムメンテナンス案内」や「処理完了のお知らせ」のような 一時的・単発の画面 の場合、わざわざ新しいHTMLファイルを追加するよりも、スクリプト内にサッと数行のHTMLを書いて createHtmlOutput() で返却する方が圧倒的に手軽でメンテナンス性も高くなります。

実務では、この2つを用途に合わせて賢く使い分けるのがプロの現場のスタンダードです!

3. STEP1:準備!「札幌オフィス統合管理簿」のプロジェクトを開こう

それでは、実際に手を動かしながらWeb画面を作っていきましょう!
今回は第81回で作成したスプレッドシート環境をそのまま活用します。

手順

  1. 前回作成した Googleスプレッドシート 「札幌オフィス統合管理簿」 を開きます(まだ作成していない方は、新規スプレッドシートを作成し、タイトルを「札幌オフィス統合管理簿」にしてください)。
  2. 上部メニューバーの 「拡張機能」 > 「Apps Script」 をクリックします。
  3. プロジェクト名が「札幌オフィス統合ダッシュボードWebアプリ」になっているエディタ画面が開けば準備完了です!

4. STEP2:【実践】最小限のHTMLコードでWeb画面を表示してみよう!

まずは肩慣らしとして、文字を太字にしたり色を付けたりする最小限のHTMLコードを書いて、Webアプリとしてブラウザに表示させてみましょう!

1. コードを入力する

エディタ内の既存コードをすべて消去し、以下のコードを貼り付けます。

function doGet(e) {
  // ① 表示したいHTMLタグを文字列として準備する
  var htmlString = '<h1 style="color: #2b6cb0;">札幌オフィス統合ダッシュボード</h1>' +
                   '<p>現在、システムの初期設定を行っています。</p>' +
                   '<p style="color: red; font-weight: bold;">※この画面はHTMLで描画されています。</p>';

  // ② HtmlServiceを使ってHTML出力オブジェクトを生成する
  var output = HtmlService.createHtmlOutput(htmlString);

  // ③ ブラウザへ完成した画面を返す(return)
  return output;
}

2. コードのポイント解説

  • var htmlString = ‘…’;
    HTMLのタグ(<h1> や <p>)をシングルクォーテーション ‘ で囲んだ文字列として定義しています。インラインCSS(style=”…”)を使って、文字の色(color)や太さ(font-weight)を指定しています。
  • HtmlService.createHtmlOutput(htmlString);
    HTMLの文字列を引数として渡し、GASの画面表示用オブジェクトを作成しています。
  • return output;
    第81回でも解説した通り、doGet(e) 関数は最後に必ず画面データを return しなければなりません。

3. テストURL(/dev)で即座に動作確認しよう!

第81回のトラップ解説で紹介した「超便利な開発用裏技」を覚えていますでしょうか?
コードを書き換えるたびに毎回「新しいデプロイ」を行うのは非常に面倒です。開発中は テスト用URL(末尾が /dev のURL) を使うことで、エディタで「保存」を押すだけで最新画面を確認できます!

  1. エディタ上部の 「保存アイコン(フロッピーディスクのマーク)」 をクリックします(または Ctrl + S / Macは Cmd + S)。
  2. 画面右上の青い 「デプロイ」 > 「デプロイをテスト」 をクリックします。
  3. ポップアップが表示されたら、種類の部分が「ウェブアプリ」になっていることを確認し、「ウェブアプリのURL」 の横にあるコピーアイコンをクリックします(URLの末尾が /dev になっています)。
  4. ブラウザの新しいタブを開き、コピーしたURLを貼り付けてアクセスしてみましょう!

実行結果の確認

ブラウザの画面に、青色の大きな見出し「札幌オフィス統合ダッシュボード」と、赤色の太字テキストが綺麗に表示されましたね!
前回の白黒のプレーンテキストとは違い、文字に色や大きさがついた「Webページ」として描画されていることが実感できたはずです。

5. STEP3:【実践発展】プロ仕様の「札幌オフィス システムメンテナンス案内画面」を作ろう!

基本が理解できたところで、実務の現場でそのまま使える本格的な画面を作っていきましょう!
札幌オフィスのスタッフがアクセスした際に、「あ、いまメンテナンス中なんだな」「何時まで待てばいいのか」が一目でわかる、美しく洗練されたメンテナンス告知カード画面を作成します。

今回は、JavaScriptの最新記法である テンプレートリテラル(バッククォート “) を使用して、複数行にわたるHTMLとCSSを綺麗に記述します。

1. コードを更新する

GASのエディタに戻り、コードを以下のように書き換えて保存してください。

/**
 * 札幌オフィス統合ダッシュボード:システムメンテナンス画面表示スクリプト
 */
function doGet(e) {
  // バッククォート(`)を使うことで、改行を含む長文HTML/CSSを直感的に記述できます
  var htmlContent = `
    <!DOCTYPE html>
    <html lang="ja">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <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: #f0f4f8;
          color: #2d3748;
          display: flex;
          align-items: center;
          justify-content: center;
          min-height: 100vh;
          padding: 20px;
        }
        /* 中央のカードコンテナ */
        .maintenance-card {
          background-color: #ffffff;
          max-width: 540px;
          width: 100%;
          border-radius: 12px;
          box-shadow: 0 10px 25px rgba(0, 0, 0, 0.08);
          overflow: hidden;
          text-align: center;
          border-top: 6px solid #dd6b20; /* 札幌の夕暮れをイメージした温かみのあるオレンジ */
        }
        /* カード内のコンテンツエリア */
        .card-body {
          padding: 40px 30px;
        }
        /* アイコン */
        .icon {
          font-size: 56px;
          margin-bottom: 20px;
          display: inline-block;
          animation: rotateGear 10s linear infinite;
        }
        @keyframes rotateGear {
          from { transform: rotate(0deg); }
          to { transform: rotate(360deg); }
        }
        /* タイトル */
        h1 {
          font-size: 22px;
          font-weight: 700;
          color: #1a202c;
          margin-bottom: 12px;
        }
        /* リード文 */
        p.lead {
          font-size: 14px;
          color: #4a5568;
          line-height: 1.6;
          margin-bottom: 24px;
        }
        /* スケジュール詳細枠 */
        .schedule-box {
          background-color: #fffaf0;
          border: 1px dashed #dd6b20;
          border-radius: 8px;
          padding: 16px;
          margin-bottom: 24px;
          text-align: left;
        }
        .schedule-box h2 {
          font-size: 13px;
          color: #c05621;
          margin-bottom: 8px;
          text-transform: uppercase;
          letter-spacing: 0.05em;
        }
        .schedule-box ul {
          list-style: none;
          font-size: 13px;
          color: #4a5568;
          line-height: 1.8;
        }
        .schedule-box li strong {
          color: #2d3748;
          display: inline-block;
          width: 90px;
        }
        /* フッターお問い合わせ案内 */
        .contact-info {
          font-size: 12px;
          color: #718096;
          line-height: 1.5;
          border-top: 1px solid #e2e8f0;
          padding-top: 20px;
        }
        .contact-info a {
          color: #3182ce;
          text-decoration: none;
        }
        .contact-info a:hover {
          text-decoration: underline;
        }
      </style>
    </head>
    <body>
      <div class="maintenance-card">
        <div class="card-body">
          <div class="icon">⚙️</div>
          <h1>システム定期メンテナンス中</h1>
          <p class="lead">
            ただいま「札幌オフィス統合ダッシュボード」は定期保守・機能アップデート作業を実施しております。<br>
            作業完了まで今しばらくお待ちください。
          </p>

          <div class="schedule-box">
            <h2>作業予定スケジュール</h2>
            <ul>
              <li><strong>対象機能:</strong>全ダッシュボード・集計機能</li>
              <li><strong>実施日時:</strong>本日 18:00 〜 20:00(予定)</li>
              <li><strong>影響範囲:</strong>社内データ閲覧および打刻連携の一時停止</li>
            </ul>
          </div>

          <div class="contact-info">
            お急ぎの業務連絡やご不明点は、札幌オフィス総務・ITサポート窓口までお問い合わせください。<br>
            連絡先:<a href="mailto:support-sapporo@example.com">support-sapporo@example.com</a>
          </div>
        </div>
      </div>
    </body>
    </html>
  `;

  // HTML文字列を出力オブジェクトに変換してブラウザへ返す
  return HtmlService.createHtmlOutput(htmlContent);
}

2. デザインのこだわりポイント

  • レスポンシブ対応(<meta name=”viewport” …>)
    スマートフォンやタブレットの画面幅にも自動で最適化されるように設定しています。札幌オフィスへ移動中の地下鉄内からスマホで開いても、文字が小さくならず完璧なカード型レイアウトで表示されます。
  • 中央寄せのカードUI(Flexbox)
    CSSの display: flex; を活用し、PC画面でも常にブラウザの真ん中に美しい影(ボックスシャドウ)付きのカードが配置されるように設計しています。
  • CSSアニメーション(@keyframes rotateGear)
    設定した歯車アイコン(⚙️)がゆっくりと回転し、「現在作業が進行していること」を視覚的に伝える遊び心を取り入れています。

3. 表示を確認してみよう!

コードを保存したら、先ほど開いたテスト用URL(末尾が /dev のページ)のタブを再読み込み(リロード:F5 または Cmd + R)してください。

どうでしょうか?
まるで大手IT企業のサービスのような、洗練された「システムメンテナンス案内画面」が美しく中央に表示されたはずです!
これが、GASの HtmlService.createHtmlOutput() が持つ表現力の高さです。

6. STEP4:実務で役立つ!createHtmlOutput() の応用テクニック3選

単に固定のHTMLを表示するだけでなく、実務の開発で差がつく3つの強力な応用テクニックをご紹介します!

応用①:テンプレートリテラルで「変数」をHTML内に埋め込む

JavaScriptのテンプレートリテラル(バッククォート “)を使えば、${変数名} と書くだけで、プログラム内で計算した数値や文字列をHTMLの好きな場所に一瞬で埋め込むことができます。

function doGet(e) {
  var officeName = "札幌オフィス";
  var finishTime = "21:30"; // 動的に変更したい終了予定時刻

  var html = `
    <div style="font-family: sans-serif; text-align: center; padding: 50px;">
      <h2>【${officeName}】システムメンテナンス案内</h2>
      <p>メンテナンス終了予定時刻は <b>${finishTime}</b> です。</p>
    </div>
  `;

  return HtmlService.createHtmlOutput(html);
}

文字列の足し算(+)でつなぐ必要がないため、コードが劇的にすっきりと読みやすくなります!

応用②:第29回 Utilities.formatDate() と組み合わせて動的日時を表示する

第29回で学んだ Utilities.formatDate() を組み合わせれば、「現在のアクセス日時」や「2時間後の復旧予定時刻」を自動計算してメンテナンス画面にリアルタイム表示させることができます。

function doGet(e) {
  // 現在時刻から2時間後を計算する
  var now = new Date();
  var recoveryTime = new Date(now.getTime() + (2 * 60 * 60 * 1000));

  // 第29回の知識:日本時間の「HH:mm」形式にフォーマット
  var formattedRecovery = Utilities.formatDate(recoveryTime, "Asia/Tokyo", "HH:mm");

  var html = `
    <div style="padding: 30px; font-family: sans-serif; text-align: center;">
      <h3>システム緊急メンテナンス中</h3>
      <p>復旧見込み時刻:<strong>本日 ${formattedRecovery} 頃</strong></p>
    </div>
  `;

  return HtmlService.createHtmlOutput(html);
}

わざわざ手作業でHTMLの時間を書き直さなくても、常にアクセスされたタイミングに合わせて最適な予定時刻を提示できるようになります。

応用③:第81回の e.parameter と連動して「画面を切り替える」

第81回で学んだイベントオブジェクト e.parameter と if 文を組み合わせることで、「通常時はシステム利用画面、緊急時はURLパラメータでメンテナンス画面に切り替える」といった制御が可能になります!

function doGet(e) {
  // URLパラメータ mode の値を取得(例: ?mode=maintenance)
  var mode = e.parameter.mode;

  if (mode === "maintenance") {
    // メンテナンス案内画面を出力
    var maintenanceHtml = `<h2 style="color:orange;">現在メンテナンス中です</h2>`;
    return HtmlService.createHtmlOutput(maintenanceHtml);
  }

  // 通常時の画面を出力
  var normalHtml = `<h2 style="color:green;">ダッシュボードは正常に稼働しています</h2>`;
  return HtmlService.createHtmlOutput(normalHtml);
}

このように組んでおけば、URLの末尾に ?mode=maintenance を付けるだけで、訪問者に表示する画面を意図的に切り替えることができるようになります!

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

HtmlService.createHtmlOutput() を使ってWeb画面を制作する際、初心者が非常によく遭遇するエラーやトラブルを5つ厳選しました。ここでしっかり予習しておきましょう!

トラップ1:クォーテーションの衝突による構文エラー(SyntaxError)

HTMLタグの属性(class=”…” や style=”…”)にはダブルクォーテーション ” が多用されます。
そのため、JavaScriptの文字列を ” で囲ってしまうと、途中で文字列が途切れてしまいエラーになります。

// ✕ NGな書き方(style="color:red;" のダブルクォーテーションと衝突する)
var html = "<p style="color:red;">文字</p>"; // SyntaxError発生!

// ◯ OKな書き方(外側をシングルクォーテーションにする、またはバッククォートを使う)
var html = '<p style="color:red;">文字</p>';
var html = `<p style="color:red;">文字</p>`; // テンプレートリテラルが最も安全!

トラップ2:本番URL(/exec)で開くと画面が古いまま変わらない!

第81回でも触れましたが、Webアプリの本番公開用URL(末尾が /exec のURL)は、「デプロイの更新」を行わない限り、コードを書き換えても画面が絶対に変わりません。

解決策

  • 開発・テスト段階では、必ず 「デプロイをテスト」から取得した /dev で終わるテスト用URL を使用する。
  • 本番URLに反映させる時は、画面右上の 「デプロイ」 > 「デプロイを管理」 > 鉛筆マーク(編集) > 「バージョン: 新規バージョン」 を選んでからデプロイボタンを押す!

トラップ3:外部CSS(Bootstrapなど)やWebフォントが読み込めない?

HTMLの <head> 内で外部のCDNライブラリやGoogle Fontsを読み込もうとしても、うまくスタイルが反映されないことがあります。

解決策

GASのWebアプリは、セキュリティを高めるためGoogleの特殊なサンドボックス環境(IFRAME モード)の中で実行されます。外部リソースを読み込む際は、必ず https:// から始まる完全なURLを指定し、必要に応じて <base target=”_top”> を <head> 内に記述するルールを守りましょう。

トラップ4:createHtmlOutput() と createHtmlOutputFromFile() の取り違え

// ✕ エラーになる書き方(HTML文字列なのに FromFile を使っている)
HtmlService.createHtmlOutputFromFile("<h1>こんにちは</h1>");
// ➔ Exception: No item with the given name could be found.
  • HTMLコードの文字列を直接渡す ➔ createHtmlOutput()
  • 左メニューにあるファイル名を渡す ➔ createHtmlOutputFromFile()

1単語の違いですが、役割が完全に異なりますのでタイポに注意しましょう!

トラップ5:doGet(e) 内で return を書き忘れる

function doGet(e) {
  var output = HtmlService.createHtmlOutput("<h1>札幌オフィス</h1>");
  // return を書き忘れている!
}

これを実行すると、ブラウザには「スクリプトが完了しましたが、何も返されませんでした」という真っ白なエラー画面が表示されてしまいます。
必ず処理の末尾で return output; と記述して、生成したオブジェクトをブラウザへ手渡してください。

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

今回は、GASで自由自在にWeb画面を描画する基本命令 HtmlService.createHtmlOutput() の使い方と、実務で使える「システムメンテナンス案内画面」の作成手順を詳しく解説しました!

今日の重要ポイントおさらい

  1. HtmlService.createHtmlOutput(“HTML文字列”) で、デザインされたWeb画面を生成できる!
  2. doGet(e) の中で生成し、最後に必ず return でブラウザへ返すのが基本ルール。
  3. JavaScriptのテンプレートリテラル(バッククォート “)を使えば、複数行のHTML/CSSも美しく管理できる。
  4. ${変数名} を使って、動的な時間やオフィス名をHTML内へ簡単に埋め込める。
  5. 開発中の表示確認には、デプロイ不要でリアルタイム反映されるテスト用URL(/dev)を使うと爆速で作業できる!

これで、文字だけの無機質な出力から卒業し、デザインされたWebページを自分自身の手でインターネット上に公開できるようになりましたね!

次回予告

今回はコードの中にHTML文字列を直接書く手法を学びましたが、本格的な「札幌オフィス統合ダッシュボード」を作るとなると、数百行にも及ぶHTML・CSS・JavaScriptのコードをすべて .gs ファイルの中に書くのは管理が大変ですし、コードがごちゃごちゃになってしまいますよね。

そこで次回(第83回)は、エディタ内に独立したHTMLファイルを作成し、美しく整理されたコードからWeb画面を呼び出す HtmlService.createHtmlOutputFromFile() を解説します!

いよいよ、グラフやカードが美しく並ぶモダンな「ダッシュボードメイン画面」の設計に入っていきます。本格的な社内Webシステム開発の醍醐味をぜひ味わってください。次回もお楽しみに!