Google Apps Script(GAS)で社内向けのWebアプリケーションやダッシュボードを開発していると、利用者やチームメンバーからこんな相談を受けることがよくあります。
「営業部用の売上KPIだけをブックマークして、毎朝1クリックで開けるようにしたい」
「開発チームは会議室の予約状況をメインで見たいから、最初からその画面が開くURLがほしい」
「同じWebアプリなのに、部署や役職ごとに表示したい情報がバラバラで困っている……」
こうした場合、画面や部署ごとにGASのプロジェクトを別々に作って、何本もWebアプリをデプロイしていませんか?
画面が2〜3個ならまだしも、部署が増えたり機能が増えたりするたびに別々のスクリプトを保守するのは、エンジニアにとってまさに悪夢ですよね。コードを1箇所修正するたびに、すべてのプロジェクトを開いて再デプロイ……なんて作業を手動で繰り返していたら、いくら時間があっても足りません。
そこで今回マスターするのが、1つのWebアプリケーションの中で、URLの末尾に添えた文字に応じて表示する画面や取得するデータを自由自在に切り替える e.parameter(イベントパラメータ) です!
Webの世界では、URLの後ろに ?view=kpi&dept=sales のような文字列を添えてページの状態を制御する仕組みを「URLパラメータ(クエリパラメータ)」と呼びます。GASの doGet(e) と e.parameter を組み合わせれば、たった1つのWebアプリURLで何通りもの画面を切り替える本格的な「ルーティング(画面振り分け)」が実現できます。
今回も、札幌オフィスの現場で実際に運用されている「札幌オフィス統合ダッシュボード」を題材に、URLパラメータの基礎知識から、スプレッドシートと連動した部署別データの動的表示、そして実務で安全に運用するためのプロのテクニックまで、どこよりも分かりやすく徹底解説していきます!
1. そもそも e.parameter とは?URLパラメータ(クエリ文字列)の仕組み
まずは、「URLパラメータとは何か?」「GASはそれをどうやって受け取るのか?」という根本的な仕組みから解き明かしていきましょう。
URLパラメータ(クエリ文字列)の解剖図
普段、Amazonで買い物をしたりGoogleで検索したりするとき、ブラウザのアドレスバーに ? や & が混ざった長いURLが表示されているのを目にしますよね。あの ? 以降の文字列のことを「URLパラメータ(クエリ文字列)」と呼びます。
https://script.google.com/.../exec?view=kpi&dept=sales
?:パラメータの開始の合図(クエスチョンマーク)
view:キー①(パラメータ名)
kpi:値①(kpi:業績画面)
&:複数のパラメータをつなぐ区切り記号
dept:キー②(パラメータ名)
sales:値②(sales:営業部)
- ?(クエスチョンマーク):ここから先がパラメータ(追加データ)ですよ、という開始の目印です。
- キー=値:「何を=どんな内容で」というペアを指定します(例:
view=kpi)。 - &(アンパサンド):複数のパラメータを並べたいときに、間をつなぐ接着剤の役割を果たします。
「カフェのカスタム注文シート」でイメージしよう!
この仕組みは、カフェでドリンクを注文するときの「カスタマイズ伝票」に例えるとすんなり理解できます。
| Webの世界 | カフェでの例え | 今回のダッシュボードでの役割 |
|---|---|---|
| ベースのURL | ベースのドリンク(例:カフェラテ) | 札幌オフィス統合ダッシュボードの基本システム |
| ?view=kpi | メインの注文(例:イートインで) | 表示する画面を「売上KPI画面」に指定 |
| &dept=sales | トッピングの指定(例:ソイミルクに変更) | 絞り込む部署を「営業部」に指定 |
| e.parameter | 店員さんが受け取る注文シート | GASプログラムが受け取る注文データの箱 |
ブラウザで .../exec?view=kpi&dept=sales にアクセスすると、Googleのサーバーがこの注文シート(パラメータ)を読み取り、JavaScriptのオブジェクト(連想配列)に変換して doGet(e) の引数 e.parameter に詰めて届けてくれます。
// GASの内部で自動生成される e.parameter の中身(イメージ)
e.parameter = {
view: "kpi",
dept: "sales"
};
あとはプログラム側で「e.parameter.view が kpi なら売上画面を表示しよう」「e.parameter.dept が sales なら営業部のデータをスプレッドシートから引っ張ってこよう」と条件分岐(if文やswitch文)を書くだけで、画面とデータが鮮やかに切り替わるのです。
2. 超重要!e.parameter と e.parameters の違い
GASでURLパラメータを扱う際、ドキュメントやネット上の解説記事を見ると、語尾に s がついた e.parameters という似たプロパティが登場します。
この2つは初心者が非常につまずきやすいポイントですので、ここでスッキリ整理しておきましょう!
| プロパティ名 | 取得されるデータの形式 | 値の取り出され方 | 主な使いどころ |
|---|---|---|---|
| e.parameter(単数形)★基本はこれ! | 文字列(String) | 1つのキーに対して「最初の1つの値」を文字として取得 | 画面切り替え、部署選択、ID指定など(実務の99%) |
| e.parameters(複数形) | 配列(Array) | すべての値を「配列の中に格納」して取得 | チェックボックスの複数選択(例: ?tag=gas&tag=dx) |
例えば、?view=kpi&dept=sales というURLでアクセスされた場合、それぞれの変数の中身は以下のようになります。
// e.parameter(単数形):値がそのまま文字列で入る
Logger.log(e.parameter.dept);
// ➔ "sales"
// e.parameters(複数形):値が配列に入って届く
Logger.log(e.parameters.dept);
// ➔ ["sales"]
もし間違えて e.parameters.dept === "sales" と比較してしまうと、「配列」と「文字列」を比べているため判定が一致せず(false になり)、画面の切り替えが失敗してしまいます。
「URLから値を取るときは、原則として単数形の e.parameter を使う!」 と覚えておけば間違いありません。
3. STEP1:準備!「札幌オフィス統合管理簿」に部署別データを整備しよう
それでは、実際に手元の環境で動かすための準備をしていきましょう!
今回は、第81回〜第84回で使ってきたGoogleスプレッドシート「札幌オフィス統合管理簿」の中に、部署別の売上データと予約データを用意します。
1. 「売上実績」シートの作成
スプレッドシートを開き、「売上実績」というシートタブに以下の表データを入力してください。A列に「部署コード」、B列に「部署名」、C列に「達成率」、D列に「売上金額」を配置します。
| A列(dept_id) | B列(部署名) | C列(達成率) | D列(売上実績) | E列(前年比) |
|---|---|---|---|---|
| all | 全社合計 | 118.2% | 45,600,000円 | +12.4% |
| sales | 札幌営業部 | 124.8% | 18,720,000円 | +18.5% |
| dev | 開発推進部 | 112.0% | 15,400,000円 | +8.2% |
| mkt | マーケティング部 | 115.5% | 11,480,000円 | +10.1% |
2. 「会議室予約」シートの作成
もう1枚の「会議室予約」シートには、それぞれの部署が利用している会議室やスペースの状況を入力します。A列に部署コードを入れておくことで、後ほどパラメータに応じたフィルタリングができるように準備します。
| A列(dept_id) | B列(施設名) | C列(利用時間) | D列(ミーティング内容) | E列(状況) |
|---|---|---|---|---|
| sales | 第1会議室(テレビ会議) | 10:00 – 11:30 | 道内大手流通チェーン様 オンライン商談 | 利用中 |
| dev | 集中開発ポッドA | 13:00 – 15:00 | 札幌観光アプリ スプリントレビュー | 予約あり |
| mkt | 第2ミーティングスペース | 14:00 – 15:30 | 秋の味覚コラボ企画 キャンペーン分析会 | 予約あり |
| sales | 第1会議室(テレビ会議) | 16:00 – 17:00 | 東京本社・札幌営業部 週間パイプライン共有 | 予約あり |
| all | オープンスペース | 17:30 – 18:30 | 札幌オフィス全体 夕礼&成果発表会 | 即時利用可 |
データが準備できたら、スプレッドシート上部メニューの 「拡張機能」 > 「Apps Script」 をクリックして、GASのエディタ画面を開きましょう!
4. STEP2:【実践】最小限のコードで e.parameter の動きを体感しよう!
まずは肩慣らしとして、URLに付けたパラメータが本当にプログラム側で読み取れているのか、最小限のコードでテストしてみましょう。
1. コードを入力する
エディタ内の既存コードをすべて消去し、以下のスクリプトを貼り付けます。
/**
* 第85回 STEP2:e.parameter の基本動作確認
* URLの ?view=〇〇&dept=〇〇 を受け取ってテキストで返却する
*/
function doGet(e) {
// ① e.parameter からパラメータを取り出す(未指定時のデフォルト値も設定)
var viewParam = e.parameter.view || "未指定(デフォルト)";
var deptParam = e.parameter.dept || "未指定(デフォルト)";
// ② ログに確認用テキストを組み立てる
var responseText = "【URLパラメータ受信テスト】\n\n" +
"・viewパラメータ(表示画面): " + viewParam + "\n" +
"・deptパラメータ(対象部署): " + deptParam + "\n\n" +
"GASは正常にURLパラメータを受け取っています!";
// ③ ブラウザへテキストを出力
return ContentService.createTextOutput(responseText);
}
2. 開発用テストURL(/dev)で動作確認しよう!
第81回〜第84回でも解説した通り、パラメータのテストを行う際も 開発用テストURL(末尾が /dev のURL) を使えば、デプロイ作業を挟まずに即座に動作を確認できます。
- エディタ上部の 「保存アイコン(フロッピーディスク)」 をクリックします。
- 画面右上の青い 「デプロイ」 > 「デプロイをテスト」 をクリックします。
- 表示されたダイアログから 「ウェブアプリのURL」(末尾が
/devのURL)をコピーします。 - ブラウザの新しいタブを開き、アドレスバーに貼り付けます。
まずは、パラメータを何もつけずにそのまま Enterキー を押してアクセスしてみましょう。
【URLパラメータ受信テスト】
・viewパラメータ(表示画面): 未指定(デフォルト)
・deptパラメータ(対象部署): 未指定(デフォルト)
GASは正常にURLパラメータを受け取っています!
次に、URLの末尾に ?view=kpi&dept=sales を書き足してアクセスしてみます!
https://script.google.com/macros/s/.../dev?view=kpi&dept=sales
画面を再読み込みすると……?
【URLパラメータ受信テスト】
・viewパラメータ(表示画面): kpi
・deptパラメータ(対象部署): sales
GASは正常にURLパラメータを受け取っています!
見事にURLの文字をプログラムがキャッチしてくれましたね!
?view=room&dept=dev など、URLの文字を自由に変えてリロードしてみてください。打ち替えた通りの文字列がリアルタイムに取得できることが体感できるはずです。
5. STEP3:【本格実践】画面と部署別データを動的に切り替える完全ルーティング実装!
仕組みがバッチリ掴めたところで、いよいよ本番のマルチビューダッシュボードを構築していきましょう!
前回(第84回)で作成した createTemplateFromFile() と組み合わせ、以下の2つの軸で画面を動的に切り替えます。
- view パラメータ(表示する画面の切り替え):
?view=kpi➔ 「売上・業績KPIサマリー画面」を表示?view=room➔ 「会議室・施設リアルタイム予約状況画面」を表示- パラメータなし(またはその他) ➔ 「統合ダッシュボード(全体画面)」を表示
- dept パラメータ(部署データの絞り込み):
&dept=sales➔ 札幌営業部の実績&予約に絞り込み&dept=dev➔ 開発推進部の実績&予約に絞り込み&dept=mkt➔ マーケティング部の実績&予約に絞り込み- 指定なし ➔ 全社合計データを表示
1. バックエンド(Code.gs)の実装
左側のファイル一覧から コード.gs を開き、中身を以下の完全版コードに書き換えて保存してください。
/**
* 札幌オフィス統合ダッシュボード Webアプリケーション
* URLパラメータ(view, dept)に応じて動的に画面とデータを切り替えるルーティング処理
*/
function doGet(e) {
// ① URLパラメータの取得とデフォルト値の設定
// e.parameter が未定義(undefined)の場合の安全対策として (e.parameter || {}) を使用
var params = e.parameter || {};
var currentView = params.view || "dashboard"; // 指定がなければ "dashboard"
var currentDept = params.dept || "all"; // 指定がなければ "all" (全社)
var ss = SpreadsheetApp.getActiveSpreadsheet();
// -------------------------------------------------------------
// ② 部署に応じた「売上KPIデータ」の抽出
// -------------------------------------------------------------
var salesSheet = ss.getSheetByName("売上実績");
var salesData = salesSheet.getRange(2, 1, salesSheet.getLastRow() - 1, 5).getValues();
var targetKpi = null;
for (var i = 0; i < salesData.length; i++) {
if (salesData[i][0] === currentDept) {
targetKpi = {
deptId: salesData[i][0],
deptName: salesData[i][1],
rate: salesData[i][2],
sales: salesData[i][3],
growth: salesData[i][4]
};
break;
}
}
// もし該当部署が見つからなかった場合は「全社(all)」にフォールバック
if (!targetKpi) {
targetKpi = {
deptId: "all",
deptName: "全社合計(デフォルト)",
rate: salesData[0][2],
sales: salesData[0][3],
growth: salesData[0][4]
};
currentDept = "all";
}
// -------------------------------------------------------------
// ③ 部署に応じた「会議室予約データ」の抽出(Array.filterの復習!)
// -------------------------------------------------------------
var roomSheet = ss.getSheetByName("会議室予約");
var roomData = roomSheet.getRange(2, 1, roomSheet.getLastRow() - 1, 5).getValues();
var filteredRooms = [];
if (currentDept === "all") {
// 全社指定の場合はすべての予約を表示
filteredRooms = roomData;
} else {
// 第15回で学んだ Array.filter() とアロー関数で特定部署の予約だけを抽出!
filteredRooms = roomData.filter(function(row) {
return row[0] === currentDept || row[0] === "all"; // 自部署または全社共有の予約
});
}
// -------------------------------------------------------------
// ④ HTMLテンプレートの読み込みとデータの流し込み(第84回)
// -------------------------------------------------------------
var template = HtmlService.createTemplateFromFile("index");
// テンプレートへ渡す変数たち
template.view = currentView;
template.dept = currentDept;
template.kpi = targetKpi;
template.rooms = filteredRooms;
template.updatedTime = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");
// ⑤ テンプレートを評価してHTML化
var htmlOutput = template.evaluate();
htmlOutput.setTitle("【札幌オフィス】統合ポータル (" + targetKpi.deptName + ")");
htmlOutput.addMetaTag("viewport", "width=device-width, initial-scale=1");
return htmlOutput;
}
2. フロントエンド(index.html)の実装
次に、HTMLファイル側でパラメータを受け取り、表示画面を動的に切り替えるロジックを組み込みます。
左側のファイル一覧から index.html を開き、中身を以下のように更新して保存してください。
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- 画面内リンクをクリックしたときにページ遷移させる必須タグ -->
<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: #f0f4f8;
color: #2d3748;
display: flex;
min-height: 100vh;
}
/* 左側ナビゲーションバー */
.sidebar {
width: 250px;
background-color: #1a365d;
color: #ffffff;
padding: 24px 16px;
display: flex;
flex-direction: column;
}
.sidebar h2 { font-size: 16px; font-weight: 700; margin-bottom: 24px; }
.nav-group-title {
font-size: 11px;
text-transform: uppercase;
color: #a0aec0;
margin: 16px 0 8px 12px;
letter-spacing: 0.05em;
}
.nav-menu { list-style: none; margin-bottom: 12px; }
.nav-item { margin-bottom: 4px; }
.nav-link {
display: block;
padding: 10px 14px;
color: #cbd5e0;
text-decoration: none;
border-radius: 6px;
font-size: 13px;
transition: all 0.2s;
}
.nav-link:hover { background-color: #2b6cb0; color: #ffffff; }
.nav-link.active {
background-color: #3182ce;
color: #ffffff;
font-weight: bold;
}
/* メインコンテンツ */
.main-content { flex: 1; padding: 32px; overflow-y: auto; }
.header {
display: flex;
justify-content: space-between;
align-items: center;
margin-bottom: 24px;
}
.header h1 { font-size: 22px; font-weight: 700; color: #1a202c; }
.header-dept-tag {
display: inline-block;
background-color: #dd6b20;
color: #ffffff;
font-size: 12px;
font-weight: 700;
padding: 4px 10px;
border-radius: 4px;
margin-left: 10px;
vertical-align: middle;
}
.sync-time { font-size: 12px; color: #718096; margin-top: 4px; }
/* 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: 26px; font-weight: 700; color: #1a202c; }
.kpi-sub { font-size: 12px; color: #38a169; margin-top: 4px; font-weight: 600; }
/* パネル共通 */
.panel-box {
background-color: #ffffff;
padding: 24px;
border-radius: 10px;
box-shadow: 0 4px 6px rgba(0, 0, 0, 0.04);
margin-bottom: 24px;
}
.panel-box h3 {
font-size: 16px;
font-weight: 700;
margin-bottom: 16px;
border-bottom: 2px solid #edf2f7;
padding-bottom: 10px;
display: flex;
justify-content: space-between;
align-items: center;
}
/* 会議室リスト */
.room-item {
display: flex;
justify-content: space-between;
align-items: center;
padding: 14px 0;
border-bottom: 1px solid #edf2f7;
}
.room-item:last-child { border-bottom: none; }
.room-title { font-weight: bold; font-size: 14px; }
.room-desc { font-size: 12px; color: #718096; margin-top: 3px; }
/* バッジ */
.badge {
font-size: 11px;
padding: 4px 10px;
border-radius: 12px;
font-weight: 700;
}
.badge-inuse { background-color: #fed7d7; color: #9b2c2c; }
.badge-reserved { background-color: #feebc8; color: #7b341e; }
.badge-available { background-color: #c6f6d5; color: #22543d; }
@media (max-width: 768px) {
body { flex-direction: column; }
.sidebar { width: 100%; }
}
</style>
</head>
<body>
<!-- 左側サイドバー(URLパラメータ付きのリンクで画面遷移を構築!) -->
<aside class="sidebar">
<h2>🏢 札幌オフィス DX</h2>
<div class="nav-group-title">表示ビュー選択</div>
<ul class="nav-menu">
<li class="nav-item">
<a href="?view=dashboard&dept=<?= dept ?>" class="nav-link <?= (view === 'dashboard') ? 'active' : '' ?>">
📊 統合ダッシュボード
</a>
</li>
<li class="nav-item">
<a href="?view=kpi&dept=<?= dept ?>" class="nav-link <?= (view === 'kpi') ? 'active' : '' ?>">
📈 業績KPI詳細
</a>
</li>
<li class="nav-item">
<a href="?view=room&dept=<?= dept ?>" class="nav-link <?= (view === 'room') ? 'active' : '' ?>">
📅 会議室予約一覧
</a>
</li>
</ul>
<div class="nav-group-title">部署別フィルター</div>
<ul class="nav-menu">
<li class="nav-item">
<a href="?view=<?= view ?>&dept=all" class="nav-link <?= (dept === 'all') ? 'active' : '' ?>">
🌐 全社合計
</a>
</li>
<li class="nav-item">
<a href="?view=<?= view ?>&dept=sales" class="nav-link <?= (dept === 'sales') ? 'active' : '' ?>">
💼 札幌営業部
</a>
</li>
<li class="nav-item">
<a href="?view=<?= view ?>&dept=dev" class="nav-link <?= (dept === 'dev') ? 'active' : '' ?>">
💻 開発推進部
</a>
</li>
<li class="nav-item">
<a href="?view=<?= view ?>&dept=mkt" class="nav-link <?= (dept === 'mkt') ? 'active' : '' ?>">
📢 マーケティング部
</a>
</li>
</ul>
</aside>
<!-- メイン表示コンテンツエリア -->
<main class="main-content">
<div class="header">
<div>
<h1>
札幌オフィス業務モニター
<span class="header-dept-tag"><?= kpi.deptName ?></span>
</h1>
<p class="sync-time">リアルタイム同期:<strong><?= updatedTime ?></strong></p>
</div>
</div>
<!-- ======================================================== -->
<!-- パターンA:view=dashboard または view=kpi のときに表示 -->
<!-- ======================================================== -->
<? if (view === 'dashboard' || view === 'kpi') { ?>
<div class="kpi-grid">
<div class="kpi-card highlight">
<div class="kpi-title">【<?= kpi.deptName ?>】当月売上達成率</div>
<div class="kpi-value"><?= kpi.rate ?></div>
<div class="kpi-sub">▲ 前年比 <?= kpi.growth ?></div>
</div>
<div class="kpi-card">
<div class="kpi-title">当月売上実績</div>
<div class="kpi-value"><?= kpi.sales ?></div>
<div class="kpi-sub" style="color: #3182ce;">正常に進捗中</div>
</div>
</div>
<? } ?>
<!-- ======================================================== -->
<!-- パターンB:view=dashboard または view=room のときに表示 -->
<!-- ======================================================== -->
<? if (view === 'dashboard' || view === 'room') { ?>
<div class="panel-box">
<h3>
<span>🕒 会議室・作業スペース予約状況 (<?= kpi.deptName ?>)</span>
<span style="font-size: 12px; font-weight: normal; color: #718096;">該当: <?= rooms.length ?> 件</span>
</h3>
<? if (rooms.length === 0) { ?>
<p style="color: #a0aec0; font-size: 13px; padding: 20px 0; text-align: center;">
現在、表示対象の会議室予約はありません。
</p>
<? } else { ?>
<? for (var i = 0; i < rooms.length; i++) {
var rDept = rooms[i][0];
var rName = rooms[i][1];
var rTime = rooms[i][2];
var rTitle = rooms[i][3];
var rStatus = rooms[i][4];
var badgeClass = "badge-available";
if (rStatus === "利用中") badgeClass = "badge-inuse";
else if (rStatus === "予約あり") badgeClass = "badge-reserved";
?>
<div class="room-item">
<div>
<div class="room-title"><?= rName ?></div>
<div class="room-desc"><?= rTime ?> 【<?= rTitle ?>】</div>
</div>
<span class="badge <?= badgeClass ?>"><?= rStatus ?></span>
</div>
<? } ?>
<? } ?>
</div>
<? } ?>
</main>
</body>
</html>
3. ブラウザで動作を確認してみよう!
コードを保存したら、テスト用URL(/dev)を開いて、実際にURLパラメータを打ち替えてみましょう!
テスト①:営業部のKPI画面を開く
https://script.google.com/.../dev?view=kpi&dept=sales
➔ 画面上部のタグが「札幌営業部」になり、売上目標達成率が営業部の数値「124.8%」に切り替わります!さらに view=kpi なので、下部の会議室一覧が隠れてKPIカードだけにフォーカスされた画面になります。
テスト②:開発部の会議室予約画面を開く
https://script.google.com/.../dev?view=room&dept=dev
➔ 画面上部のタグが「開発推進部」になり、KPIカードは非表示になり、会議室予約の欄には開発部に関連する「集中開発ポッドA」と全社夕礼の2件だけに綺麗に絞り込まれて表示されます!
テスト③:画面内のサイドバーメニューをクリックして遷移する
左側のサイドバーに並んでいる「💼 札幌営業部」や「📅 会議室予約一覧」などのリンクをクリックしてみてください!
画面上のリンクを踏むだけで、URLのパラメータが自動で書き換わり、ページが瞬時に切り替わるはずです。
サイドバーのHTMLを見ていただくと分かる通り、リンク先に href="?view=kpi&dept=<?= dept ?>" のように現在のパラメータを保持しながら別のビューへ遷移する工夫を入れています。これにより、1つのWebアプリの中でまるで複数のページを行き来しているかのような自然なユーザー体験が完成します!
6. 実務で差がつく!URLパラメータ活用のプロ技3選
基本的なルーティングができるようになったら、実務開発で必ず直面する「例外処理」や「使い勝手の向上」のためのプロ技を3つ押さえておきましょう!
プロ技①:パラメータ未指定時の「デフォルト値(初期値)」を1行で安全に担保する
ユーザーがパラメータをつけずに通常のURL(.../exec)にアクセスしたとき、e.parameter.view は undefined(未定義)になります。その状態で何もしないとプログラムが予期せぬエラーを起こす原因になります。
JavaScriptの論理和演算子 ||(または)を活用すると、1行でスッキリ初期値をセットできます。
// viewが未指定なら "dashboard" を、deptが未指定なら "all" を自動代入!
var view = e.parameter.view || "dashboard";
var dept = e.parameter.dept || "all";
プロ技②:想定外の怪しいパラメータを弾く「ホワイトリスト安全ガード」
もし悪意のあるユーザーや打ち間違いで、?dept=unknown_hacker のような存在しない部署コードが渡された場合、スプレッドシートの検索に失敗して画面が真っ白になってしまいます。
実務では、あらかじめ「許可する文字列のリスト(ホワイトリスト)」を用意しておき、リストにない文字列が届いた場合は強制的に安全な初期値へ戻すガードマンを設置するのが鉄則です。
var allowedDepts = ["all", "sales", "dev", "mkt"];
var dept = e.parameter.dept;
// 許可リストに含まれていない値が届いたら、安全な "all" に強制リセット!
if (allowedDepts.indexOf(dept) === -1) {
dept = "all";
}
プロ技③:日本語パラメータを安全に扱う「URLエンコード」の知識
今回は dept=sales や dept=dev のような半角英数字で設計しましたが、場合によっては ?user=札幌太郎 のように日本語をURLに含めたいケースもありますよね。
日本語を含むURLを扱う際は、ブラウザや環境によって文字化けを起こさないよう、JavaScriptの encodeURIComponent() と decodeURIComponent() を意識しておくと安心です。
// URLパラメータに日本語を安全に含める例
var userName = "札幌太郎";
var safeUrl = "?user=" + encodeURIComponent(userName);
// ➔ "?user=%E6%9C%AD%E5%B9%8C%E5%A4%AA%E9%83%8E" という安全な文字列に変換される
7. 初心者が100%つまずく!5大トラップと完全対処法
e.parameter を使ったWebアプリ開発で、初心者が必ずと言っていいほど直面するエラーや落とし穴をまとめました。うまく画面が切り替わらないときは、ここを1つずつチェックしてみてください!
トラップ1:パラメータ名のタイポ(大文字・小文字・全角)で undefined になる
URLで ?View=kpi(Vが大文字)と打っているのに、コード側で e.parameter.view(全部小文字)と書いていると、値が取れずに undefined になってしまいます。
対策:パラメータ名は原則として「すべて小文字の半角英数」で統一するルールを徹底しましょう。
トラップ2:<base target=”_top”> を書き忘れてリンククリックで画面が壊れる
サイドバーの <a href="?view=kpi"> をクリックしたときに、「ページの読み込みがブロックされました」と表示されて画面遷移できない現象です。
原因:GASのWebアプリはGoogleの <iframe> の中で動作しているため、リンクのターゲットを親ウィンドウ(_top)に指定しないと遷移がブロックされてしまいます。
対策:HTMLの <head> 内の最上部に、必ず <base target="_top"> を記述してください!
トラップ3:e.parameters(複数形)を使って配列比較でコケる
前述の通り、複数形の e.parameters を使うと、値が ["sales"] のように配列で返ってきます。if (e.parameters.dept === "sales") と書いても、配列と文字列は絶対に一致しないため、すべての条件分岐がすり抜けてしまいます。
対策:単一の値を扱う場合は、必ず単数形の e.parameter を使用してください。
トラップ4:本番URL(/exec)でテストして「パラメータが変わらない」と焦る
WebアプリのデプロイURLには、本番用(/exec)とテスト用(/dev)があります。コードを修正した直後に /exec?view=kpi をリロードしても、新しいコードは反映されません。
対策:コード変更を伴う動作確認は、必ず「デプロイをテスト」から取得した /dev のURLで行いましょう!
トラップ5:スプレッドシートの行番号と配列インデックスのズレ
スプレッドシートの2行目からデータを取得(getRange(2, 1, ...))したとき、配列の1行目(data[0])はスプレッドシートの「2行目」に対応します。
「スプレッドシートの1列目が A列 ➔ 配列の row[0]」というインデックスのルールを再確認しておきましょう(第13回 getValues の復習ですね!)。
8. 今回のまとめ&次回予告
今回は、URLパラメータを使って1つのWebアプリの中で画面表示や部署別データを自由自在に切り替える e.parameter のルーティングテクニックを徹底解説しました!
📌 本日の重要ポイントおさらい
doGet(e)の引数e.parameterを使えば、URLの?key=valueをオブジェクトとして取得できる!- 単一の値を取り出すときは単数形の
e.parameter、複数選択ならe.parametersを使い分ける。 - パラメータが指定されなかった場合に備えて、
e.parameter.view || "dashboard"のようにデフォルト値をセットするのが実務の鉄則。 - HTMLテンプレート側で
<a href="?view=kpi&dept=<?= dept ?>">とリンクを張ることで、画面内の自然なページ遷移を実現できる。 - 画面内リンクを正常に動作させるため、HTMLの
<head>に<base target="_top">を必ず記述する!
URLパラメータを使ったルーティングができるようになると、画面ごとに複数のスクリプトを作る無駄がなくなり、保守性も拡張性も圧倒的に優れたWebシステムが作れるようになります。
社内の各部署メンバーにも、「このURLをブックマークしておけば、自分のチームの最新情報が一発で見られるよ!」と自信を持って共有できますね!
🚀 次回予告
さて、URLパラメータで画面や部署を綺麗に切り替えられるようになりましたが、ブラウザのタブに目を向けてみてください。
どの画面を開いても、タブの名前がずっと同じだったり、長いURLのままだったりしていませんか?
次回(第86回)は、ブラウザのタブタイトルを自由自在にカスタマイズする HtmlOutput.setTitle() を徹底解説します!
画面や部署の切り替えに合わせて、「【営業部】札幌オフィス統合ダッシュボード」のようにタブ名を動的に変化させ、複数タブを開いても迷わないプロ仕様のUI仕上げを行っていきます。次回もどうぞお楽しみに!

