【GAS入門#81】GASでWebアプリを作る第一歩!doGet(e)の基本と「札幌オフィス統合ダッシュボード」の入口作成

今回から、いよいよ待ちに待った「フェーズ9:Webアプリ化編(第81回〜第90回)」に突入します!

これまでは「Googleスプレッドシートの画面」や「GASのエディタ画面」の中でプログラムを動かしてきましたが、フェーズ9からは違います。なんと、GASを使ってブラウザから誰でもアクセスできる「自分だけのオリジナルWebアプリケーション」を作成していきます!

その記念すべき第1歩となる第81回で扱うテーマが、Webアプリのすべての入口となる重要関数 doGet(e)(ドゥー・ゲット) です!

「Webアプリって作るのが難しそう…」「サーバーの設定とか必要なの?」と不安に思う必要は一切ありません。GASなら、わずか数行のコードを書くだけで自分だけのWebページをインターネット上に公開できてしまいます。

本記事では、doGet(e) の仕組みや役割から、Webアプリとして公開する「デプロイ」の具体的な手順、URLパラメータを受け取る実践テクニック、そして初心者が必ず直面する「デプロイの罠」まで、どこよりも分かりやすく徹底解説していきます!

1. そもそも doGet(e) とは?Webアプリが開く仕組みを解説

まずは、「ブラウザでWebページが開く仕組み」と doGet(e) の役割について整理しましょう。

doGet(e) の役割=Webアプリの「正面玄関の受付窓口」

普段、私たちがスマホやパソコンでWebサイトを見るとき、ブラウザ(Google Chromeなど)はサーバーに対して「このページを表示して!(GETリクエスト)」というお願いを送っています。

GASでWebアプリを作成した際、ユーザーがそのWebアプリのURLにアクセスした瞬間に、Googleのサーバー側で自動的に呼び出される特別な関数が doGet(e) です。

function doGet(e) {
  // ブラウザでURLが開かれたときに、ここに書いた処理が自動実行される!
}

第21回・第22回で学んだ onOpen(e) や onEdit(e) を覚えているでしょうか?これらは「スプレッドシートが開かれた時」や「セルが編集された時」に自動起動するシンプルトリガーでしたね。

doGet(e) もその仲間で、「WebアプリのURLにブラウザからアクセス(GET)された時に自動起動する特効関数」なのです。

「お店の受付カウンター」でイメージしよう!

Webアプリの仕組みは、「札幌オフィス統合ダッシュボード」というお店の受付窓口に例えると非常にイメージしやすくなります。

  • ユーザー(ブラウザ):お店のドアを開けて入ってくる「お客さん」
  • URLへのアクセス:お客さんが「こんにちは!お店の画面を見せてください」と頼むこと(GETリクエスト)
  • doGet(e):ドアが開いた瞬間に「いらっしゃいませ!」と対応する「受付スタッフ」
  • 戻り値(return):受付スタッフがお客さんに手渡す「パンフレット(HTML画面やテキスト)」

つまり、doGet(e) という受付スタッフがいないと、お客さんがURLにアクセスしても「誰も対応してくれない…」ということになり、Webアプリとして成り立たないのです。

2. 引数 (e) ってなに?イベントオブジェクトの正体

doGet(e) のカッコの中にある e という文字。これは イベントオブジェクト(Event Object) と呼ばれるデータのかたまりです。

e はお客さんが持ってきた「注文メモ」

お客さん(ユーザー)がWebアプリにアクセスするとき、単にページを開くだけでなく、「札幌オフィスのデータを見たい」「営業部の画面を開いてほしい」といったリクエスト情報(URLパラメータなど)を一緒に持ってくることがあります。

GASは、そのアクセス時のさまざまな情報を e という1つの箱にまとめて doGet(e) に手渡してくれます。

e に入っている主な情報役割・内容
e.parameterURLの末尾に付けられたパラメータ(例: ?dept=sales)を単一のオブジェクトとして取得する
e.queryStringURLの ? 以降の文字列全体を取得する
e.contentLengthリクエストされたコンテンツの長さを取得する

特に重要なのが e.parameter です。これを使うことで、URLの書き方によって表示する画面や処理を動的に切り替えることができるようになります(後ほど詳しく実践します!)。

3. STEP1:準備!「札幌オフィス統合管理簿」を作成しよう

それでは、実際にGASでWebアプリを作成する準備を進めましょう!

今回は「札幌オフィス統合ダッシュボードWebアプリ」の第一歩として、スプレッドシートに紐づくコンテナバインドスクリプトで作成していきます。

手順

  1. ブラウザで新しいGoogleスプレッドシートを作成し、ファイル名を 「札幌オフィス統合管理簿」 にします。
  2. 画面下のシートタブ名を 「ダッシュボード情報」 に変更しておきます。
  3. 上部メニューバーの 「拡張機能」 > 「Apps Script」 をクリックします。
  4. エディタ画面が開いたら、プロジェクト名を 「札幌オフィス統合ダッシュボードWebアプリ」 に変更しましょう。

4. STEP2:【実践】最小限の doGet(e) を書いてWebアプリを公開(デプロイ)してみよう!

準備ができたら、まずは一番シンプルなコードを書いて、実際にインターネット上にWebアプリとして公開してみましょう!

1. コードを入力する

エディタに最初から入っているコードをすべて消去し、以下のコードを貼り付けます。

function doGet(e) {
  // ブラウザに表示するシンプルなメッセージを作成する
  var output = ContentService.createTextOutput("札幌オフィス統合ダッシュボードWebアプリへようこそ!");
  
  // 作成したメッセージをブラウザへ返す(返却する)
  return output;
}

💡 ここがポイント!

ContentService.createTextOutput() は、指定した文字列をWebページとして画面に出力するためのGAS標準サービスです。第82回・第83回ではここを HtmlService に進化させて、本格的なデザイン画面を作っていきます!

2. コードを保存する

エディタ上部の 「保存(フロッピーディスクのマーク)」 を押します。

3. 超重要!Webアプリを公開(デプロイ)する手順

コードを書いただけでは、まだWebアプリとして世界(ブラウザ)からアクセスすることはできません。書きあがったプログラムをインターネット上に公開する作業を 「デプロイ(Deploy)」 と呼びます。

Google Apps Scriptでの最新のデプロイ手順を、写真を見るように1ステップずつ解説します!

【デプロイの手順 4ステップ】

  1. 「デプロイ」ボタンをクリック
    画面右上にある青い 「デプロイ」 > 「新しいデプロイ」 をクリックします。
  2. 種類の選択
    左側の歯車マーク(デプロイのタイプの選択)をクリックし、「ウェブアプリ」 を選択します。
  3. 設定項目の入力
    以下の通りに設定を行います。
    • 説明:第1回公開(初期テスト) などわかりやすいメモを入力
    • 次のユーザーとして実行:「自分(ご自身のアカウント)」 を選択(※ユーザーが誰であれ、プログラムはあなたのアカウントの権限で動作します)
    • アクセスできるユーザー:「全員」(または「Google アカウントを持つ全員」)を選択(※開発テスト時は「自分のみ」でも構いませんが、「全員」にすると誰のブラウザからでも開けるようになります)
  4. デプロイを実行してURLを取得!
    右下の 「デプロイ」 ボタンをクリックします。(※初回のみ権限の承認画面が出ることがあるので、画面の指示に従ってアクセスを「許可」してください。承認手順は第2回で学んだ通りです!)

完了画面が表示されると、「ウェブアプリ」 という項目の下に長めの URL(https://script.google.com/macros/s/.../exec) が発行されます。

このURLの横にある 「コピー」 ボタンを押して、ブラウザの新しいタブに貼り付けて開いてみましょう!

画面に 「札幌オフィス統合ダッシュボードWebアプリへようこそ!」 と文字が表示されたら、Webアプリ化の第一歩は大成功です!

5. STEP3:引数 e を活用!URLパラメータ(e.parameter)を受け取ってみよう

ウェブアプリの入口ができたところで、今度は引数 (e) を使って、アクセスしてきたユーザーの指定(パラメータ)に応じた動的なメッセージを表示させてみましょう!

たとえば、WebアプリのURLの末尾に以下のような文字(クエリ文字列)を付け加えてアクセスしてみます。

URL.../exec?user=札幌太郎&dept=営業部

  • ?:ここからパラメータが始まりますよ、という合図
  • user=札幌太郎:user という変数に 札幌太郎 をセット
  • &:パラメータを複数つなぐ区切り記号
  • dept=営業部:dept という変数に 営業部 をセット

これを doGet(e) 側で読み取ってみましょう!

1. コードを更新する

GASのエディタに戻り、doGet(e) のコードを以下のように書き換えます。

function doGet(e) {
  // URLパラメータ(e.parameter)から値を取り出す
  // パラメータが指定されていない場合の初期値(デフォルト値)も準備しておく
  var userName = e.parameter.user || "ゲスト";
  var department = e.parameter.dept || "所属なし";
  
  // 表示用メッセージを組み立てる
  var message = "■ 札幌オフィス統合ダッシュボード ■\n\n" +
                "ようこそ、" + department + "の " + userName + " さん!\n" +
                "本日のシステムは正常に稼働しています。";
  
  // ブラウザへテキストを出力
  return ContentService.createTextOutput(message);
}

2. 重要!コードを変更した時の「デプロイ更新」作業

GASでWebアプリを作るときに、全開発者が必ず一度はハマる最大の罠が「コードを書き換えたのに、Webアプリの画面が変わらない!」という問題です。

GASのWebアプリは、コードを書き換えて「保存」を押しただけでは公開中のアプリに反映されません。「デプロイの更新」 という作業が必要になります。

【正しい更新手順】

  1. 画面右上の 「デプロイ」 > 「デプロイを管理」 をクリックします。
  2. 左側で現在動いているデプロイを選択し、右上にある 「鉛筆マーク(編集)」 をクリックします。
  3. 「バージョン」 の項目で 「新規バージョン」 を選択します。(※ここを忘れると古いバージョンのままになり反映されません!)
  4. 右下の 「デプロイ」 ボタンをクリックします。

3. ブラウザで確認してみよう!

発行されたURLの末尾にパラメータを付けてブラウザで開いてみましょう。

【テスト用URLの例】

https://script.google.com/macros/s/〜〜〜/exec?user=札幌太郎&dept=開発部

【ブラウザ画面の表示】

■ 札幌オフィス統合ダッシュボード ■

ようこそ、開発部の 札幌太郎 さん!
本日のシステムは正常に稼働しています。

URLの user= や dept= の部分を「user=新千歳花子&dept=総務部」に変えて再読み込みすると、画面の文字がリアルタイムに変化するのが確認できるはずです!

これが、doGet(e) と e.parameter を使った動的Webアプリケーションの基本原理です。第85回ではこの仕組みを応用して、ダッシュボードの表示画面(KPI画面、売上画面、予約画面など)を切り替える処理を作成していきます!

6. 初心者が100%ハマる!doGet(e) の5大トラップと解決策

初めてWebアプリを作成する際によく直面するトラブルと、その解決策をまとめました。困ったときはまずここをチェックしてみてください!

トラップ1:コードを修正したのに画面が変わらない!

  • 原因:デプロイのバージョンを「新規バージョン」に更新していない。
  • 解決策:コード修正後は、必ず「デプロイを管理」>「編集(鉛筆マーク)」>「新規バージョン」を選んで再デプロイしてください。
  • 裏技:開発テスト中は、WebアプリのURLの末尾を /exec から /dev に変えた「テスト用URL」を使うと、デプロイしなくても「保存」するだけで最新コードが即座に反映されるため大変便利です!

トラップ2:doGet の大文字・小文字を間違えている

  • ✕ doget(e) / DO_GET(e) / DoGet(e)
  • ◯ doGet(e)
  • 原因:GASはJavaScriptベースのため、大文字・小文字を厳格に区別します。G のみ大文字で書きましょう。

トラップ3:return(返却)を書いていない・忘れている

  • 症状:URLを開くと「スクリプトが完了しましたが、何も返されませんでした」というエラー画面が出る。
  • 原因:doGet(e) は、最後に必ずブラウザへ表示するオブジェクトを return(返却)しなければなりません。return ContentService... や return HtmlService... があるか確認しましょう。

トラップ4:「アクセス権限が必要です」と表示されて開けない

  • 原因:デプロイ時の「アクセスできるユーザー」の設定が厳しすぎる(「自分のみ」になっているなど)。
  • 解決策:他の人や別ブラウザからアクセスさせたい場合は、デプロイ設定で「アクセスできるユーザー」を「全員」に変更してください。

トラップ5:複数のGoogleアカウントに同時ログインしていてエラーになる

  • 症状:Google Workspaceと個人用Gmailなど、1つのブラウザで複数のGoogleアカウントにログインしていると、GASのWebアプリ実行時に「drive.google.com で拒否されました」等の画面崩れエラーが起きることがあります。
  • 解決策:Webアプリの動作確認は、ブラウザの「シークレットウィンドウ(プライベートモード)」でURLを開いて確認するのが最も確実です!

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

今回は、GASでWebアプリケーションを構築するための最大の基本である doGet(e) の仕組みとデプロイ手順を解説しました。

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

  1. doGet(e) は、WebアプリのURLがブラウザで開かれた際に自動起動する受付窓口関数!
  2. ブラウザに画面を表示するには、必ず最後に return でコンテンツを返す!
  3. Webアプリとして公開・更新するには「デプロイ」作業が必須!
  4. URLパラメータ(e.parameter)を使えば、URLから動的にデータを受け取れる!

スプレッドシートの中だけでなく、インターネット上に自分だけのツールを公開できるWebアプリ化のパワーを感じていただけたでしょうか?

しかし、テキストのメッセージを表示するだけでは、まだ「Webアプリ」とは言いにくいですよね。

次回(第82回)は、HtmlService.createHtmlOutput() を使って、綺麗なデザインの 「システムメンテナンス案内画面」 をブラウザ上に描画する方法を解説します!いよいよ本格的なHTML表示の世界に入っていきますので、ぜひお楽しみに!