【GAS入門#87】google.script.run完全攻略!画面のボタンからGASを非同期実行して請求書を一括自動発行する方法

「Webアプリの画面にボタンを置いて、それをポチッと押したら、裏側でスプレッドシートやGoogleドキュメントが自動で動いてほしい!」

GAS(Google Apps Script)でWebアプリケーションを作っていると、誰もが必ずこのステップにたどり着きますよね。

前回(第86回)までは、スプレッドシートからデータを取得してモダンなダッシュボード画面を描画したり、URLパラメータで画面を切り替えたり、ブラウザのタブタイトルを動的に変えたりする方法を学んできました。これで「画面にデータを綺麗に見せる(表示する)」という土台は完璧に整いました。

しかし、これまでのWebアプリは、言わば「画面を開いたときにGASが用意したデータを一方的に受け取って表示するだけ」の一方通行でした。
実務で本当に作りたいのは、「画面上の『請求書を一括発行する』ボタンをクリックしたら、GASのバックエンド処理が呼び出され、Googleドキュメントの請求書テンプレートをもとにPDFが一気に自動生成される」といった、ユーザーの操作に応じてシステムが動く双方向の仕組みですよね!

そこで第87回となる今回は、ブラウザ(HTML側のJavaScript)からGoogleサーバー側(.gsのGASプログラム)の関数を直接呼び出すことができる超重要API、google.script.run を徹底解説します!

「フロントエンドとバックエンドって何が違うの?」「非同期処理ってどういうこと?」というプログラミング初心者の方が一番つまずきやすい概念から、フェーズ6で学んだGoogle Docsの請求書自動生成ロジックとの合体、実務で必須となるボタン連打防止策、そして絶対に知っておくべき5大トラップまで、どこよりも分かりやすく丁寧に解き明かしていきます。札幌オフィスの業務自動化をさらに一段上へと進化させましょう!

1. そもそも google.script.run とは?クライアントとサーバーの架け橋

まずは、今回登場する google.script.run が一体何者なのか、その仕組みと役割から順番に解剖していきましょう!

ブラウザ(手元)とGoogleサーバー(雲の上)の決定的な違い

GASでWebアプリを作るとき、コードが動く「場所」が2つに分かれています。ここをあやふやにしていると、100%エラーの迷宮に入り込んでしまいます。

区分主なファイル動いている場所できること・得意なこと
フロントエンド
(クライアント側)
index.html
(<script>タグ内)
ユーザーの手元にある「パソコンやスマホのブラウザ」ボタンのクリック検知、文字の入力、アニメーション、画面の書き換え
バックエンド
(サーバー側)
コード.gs遠く離れた「Googleのクラウドサーバー」スプレッドシートの読み書き、Googleドキュメントの生成、Gmail送信、Drive操作

手元のブラウザ(HTML)で動いているJavaScriptは、セキュリティ上の理由から、Googleドライブのファイルを直接書き換えたり、スプレッドシートを勝手に操作することは絶対にできません。
一方、Googleのサーバー(.gs)はスプレッドシートやドキュメントを自由自在に操れますが、ユーザーが「今まさにボタンをクリックした瞬間」を直接感知することはできません。

そこで必要になるのが、「ブラウザからGoogleサーバーへ『ボタンが押されたから、例の請求書作成プログラムを実行して!』と無線連絡を送る専用のホットライン」です。
このホットライン(架け橋)こそが、Googleが公式に用意してくれている google.script.run なのです!

「カフェの注文カウンター」でイメージしよう!

身近なシチュエーションで例えてみましょう。札幌駅のカフェでスープカレーやコーヒーを注文する場面を思い浮かべてみてください。

  • あなた(HTML画面のボタン):客席やカウンターにいるお客さん。「スープカレーセットをください!」と注文ボタンを押します。
  • google.script.run(注文用の専用マイク):客席のタブレットや注文口にある「厨房へオーダーを通す通信マイク」です。
  • 奥の厨房・シェフ(コード.gsのGAS関数):注文を受けて、実際に食材を炒め、ご飯を盛り付け、特製スープカレー(請求書ファイル)を作り上げます。

客席から厨房の中へ勝手に入って料理を作ることはできませんよね。必ず「注文マイク(google.script.run)」を通して、シェフ(GAS関数)に調理をお願いする——これとまったく同じ構造です!

2. 超重要!「非同期処理(Asynchronous)」ってなに?

google.script.run を使いこなす上で、初心者の方が最も混乱しやすいのが 「非同期処理(ひどうきしょり)」 という考え方です。
「非同期」という言葉を聞くだけで難しそうに感じるかもしれませんが、仕組みはとっても身近です!

「呼び出しベル(ブザー)」でイメージする同期と非同期

フードコートやカフェで料理を注文したときの様子をイメージしてみましょう。

【もしも「同期処理」だったら…】
レジで注文した後、料理が焼き上がるまでの5分間、レジカウンターの前で一歩も動かずに直立不動で待ち続けます。あなたが待っている間、後ろに並んでいる人は注文できず、あなた自身もスマホを見たり席を探したりすることが一切できません。画面がフリーズしたような状態です。

【実際の「非同期処理(google.script.run)」はこう動く!】
レジで注文すると、店員さんから「ピピッ」と鳴る「呼び出しベル(ブザー)」を渡されます。料理ができるまでの間、あなたは席に座ってスマホを触ったり、水を汲みに行ったりと自由に過ごせます。そして料理が完成した瞬間、ベルがブルブルと振動して「お待たせしました!」と知らせてくれます。

google.script.run は、まさにこの「呼び出しベル方式(非同期)」で動作します!

ブラウザで「請求書一括発行ボタン」を押した瞬間、google.script.run はGoogleサーバーへ「発行よろしく!」と合図だけ投げて、手元のブラウザはすぐに次の作業へ進みます。そのため、Google側で何十枚もの請求書を生成して数十秒かかっている間でも、ブラウザの画面が固まったり真っ白になったりすることはありません。

※なお、「処理が終わったときに呼び出しベルを鳴らして画面にお知らせする機能」については、次回(第88回)で学ぶ withSuccessHandler() や withFailureHandler() で完璧にマスターします!今回はまず、「画面のボタンからGoogleサーバーの関数を確実に呼び出す基本の連携」をガッチリ固めていきましょう。

3. google.script.run の基本文法と書き方ルール

書き方は驚くほどシンプルです。HTML側の JavaScript(<script>タグの中)に、以下のように記述します。

// 引数がない関数を呼び出す場合
google.script.run.サーバー側の関数名();

// サーバー側の関数へ引数(データ)を渡したい場合
google.script.run.サーバー側の関数名(渡したいデータ1, 渡したいデータ2);

たったこれだけです!
コード.gs 側に定義してある関数名(例:createInvoice())を、ドット(.)で繋げて書くだけで、ブラウザからクラウド上のGASを遠隔起動できます。

引数に渡せるデータと渡せないデータのルール

ブラウザからサーバーへデータを渡す際、どんなデータでも送れるわけではありません。ここには明確なルールがあります。

送れるデータ(JSONに変換可能なもの)◯送れないデータ(エラーになるもの)✕
文字列(”札幌オフィス” など)HTMLのDOM要素(document.getElementById など)
数値(154000 など)関数(function)
真偽値(true / false)循環参照を持つ複雑なオブジェクト
通常の配列([1, 2, 3] や [“営業部”, “開発部”])エラーオブジェクト(Error)
シンプルなオブジェクト(連想配列:{ name: “佐藤”, count: 5 })Dateオブジェクト(※文字列に変換して渡すのが安全!)

「文字や数字、配列やプレーンなオブジェクトなど、スッキリしたデータなら何でも送れる!」と覚えておけばOKです。

4. STEP1:準備!「請求データ管理シート」を用意しよう

それでは、実際に動くシステムを作っていきましょう!
今回は、フェーズ6(第51回〜第60回)で学んだGoogleドキュメントの請求書作成技術と組み合わせ、「Webダッシュボード上の『請求書一括発行ボタン』を押すと、スプレッドシートの未発行データを読み込み、取引先ごとの請求書ドキュメントをGoogleドライブに自動生成する」という、実務直結の実践システムを構築します!

まずは、請求データとなるスプレッドシートの準備です。

スプレッドシートの作成手順

  1. Googleドライブを開き、新しいGoogleスプレッドシートを作成します。
  2. ファイル名を 「札幌オフィス_請求管理システム」 に変更します。
  3. 画面下のシートタブ名を 「請求データ一覧」 に変更します。
  4. 1行目に見出し、2行目以降に以下のようなサンプルデータを入力してください。
A列(請求番号)B列(取引先会社名)C列(請求日)D列(品名・内容)E列(請求金額)F列(発行ステータス)
INV-202610-001株式会社札幌スープカレー本舗2026/10/25Webサイト改修・SEO対策費用165,000円未発行
INV-202610-002道産子フーズ株式会社2026/10/25業務自動化GASツール開発費用220,000円未発行
INV-202610-003北海ITソリューションズ2026/10/25クラウドインフラ設計コンサルティング330,000円未発行

F列の「発行ステータス」が「未発行」になっている3社分の請求書を、Webアプリのボタンから一撃で発行する仕掛けを作っていきます!

5. STEP2:【サーバー側】コード.gs に請求書発行処理を実装しよう!

まずはGoogleサーバー側(バックエンド)のコードです。
スプレッドシートの上部メニュー 「拡張機能」 > 「Apps Script」 を開き、コード.gs の中に以下の2つの関数を作成します。

  1. doGet(e):Webアプリの画面(HTML)を表示する関数(第81回〜第84回の復習!)
  2. generateInvoices():ブラウザから google.script.run で呼び出される、請求書ドキュメント生成関数(★今回の主役!)

エディタ画面のコードをすべて消去し、以下のスクリプトを貼り付けましょう。

/**
* 札幌オフィス統合ダッシュボード:Webアプリ表示窓口(第81回〜第84回)
*/
function doGet(e) {
// index.html を読み込んでHTML画面を生成
var htmlOutput = HtmlService.createTemplateFromFile('index').evaluate();
htmlOutput.setTitle('【札幌オフィス】請求書一括発行ダッシュボード');
htmlOutput.addMetaTag('viewport', 'width=device-width, initial-scale=1');
return htmlOutput;
}

/**
* ★本日の主役:フロントエンドから google.script.run で呼び出されるサーバー側関数
* スプレッドシートの未発行データを読み込み、Googleドキュメントの請求書を一括作成する
*/
function generateInvoices() {
Logger.log("=== 請求書一括生成処理を開始します ===");

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName("請求データ一覧");

// データが存在する最終行を取得(第11回 Sheet.getLastRow の復習)
var lastRow = sheet.getLastRow();
if (lastRow < 2) {
Logger.log("処理対象のデータ行がありません。");
return;
}

// 2行目から最終行までのデータ(A列〜F列)を2次元配列で一括取得(第13回 Range.getValues)
var dataRange = sheet.getRange(2, 1, lastRow - 1, 6);
var values = dataRange.getValues();

var createdCount = 0;

// 1行ずつループ処理でチェック(第72回の復習!)
for (var i = 0; i < values.length; i++) {
var invoiceNo = values[i][0]; // A列: 請求番号
var companyName = values[i][1]; // B列: 会社名
var rawDate = values[i][2]; // C列: 請求日
var itemName = values[i][3]; // D列: 品名
var amount = values[i][4]; // E列: 金額
var status = values[i][5]; // F列: 発行ステータス

// 「未発行」のデータのみを対象とする
if (status === "未発行") {
// 日付を「yyyy年MM月dd日」に綺麗に整形(第29回 Utilities.formatDate の復習)
var dateText = Utilities.formatDate(new Date(rawDate), "Asia/Tokyo", "yyyy年MM月dd日");

// 新規のGoogleドキュメントを作成(第51回〜第53回のDocs操作応用)
var docName = "【御請求書】" + companyName + "_" + invoiceNo;
var doc = DocumentApp.create(docName);
var body = doc.getBody();

// 請求書本文の組み立て(見出し・段落・スタイル設定)
var titlePara = body.appendParagraph("御 請 求 書");
titlePara.setHeading(DocumentApp.Heading.TITLE);
titlePara.setAlignment(DocumentApp.HorizontalAlignment.CENTER);

body.appendParagraph("請求番号:" + invoiceNo);
body.appendParagraph("請求日:" + dateText);
body.appendParagraph("");
body.appendParagraph(companyName + " 御中").setHeading(DocumentApp.Heading.HEADING2);
body.appendParagraph("平素は格別のお引き立てを賜り、厚く御礼申し上げます。\n下記の通りご請求申し上げます。");
body.appendParagraph("");

// 金額の強調表示(第55回 setFontSize / setBold)
var amountPara = body.appendParagraph("ご請求金額:" + amount + "(税込)");
amountPara.setFontSize(18);
amountPara.setBold(true);
amountPara.setForegroundColor("#C00000"); // 札幌コーポレートレッド

body.appendParagraph("");

// 明細表の作成(第56回 appendTable / 第57回 TableCell操作)
var tableData = [
["品名・作業内容", "ご請求金額"],
[itemName, amount]
];
var table = body.appendTable(tableData);

// 表のヘッダー行をネイビーに着色
var headerCell1 = table.getRow(0).getCell(0);
var headerCell2 = table.getRow(0).getCell(1);
headerCell1.setBackgroundColor("#1A365D");
headerCell2.setBackgroundColor("#1A365D");
headerCell1.editAsText().setForegroundColor("#FFFFFF").setBold(true);
headerCell2.editAsText().setForegroundColor("#FFFFFF").setBold(true);

body.appendParagraph("");
body.appendParagraph("【お振込先】\n北洋銀行 札幌駅前支店 普通 1234567\n口座名義:カ)デジタルワンダーランド");

// ドキュメントの変更を保存して閉じる(第60回参照)
doc.saveAndClose();

// スプレッドシート側のステータスを「発行済」に更新(第6回 setValue)
// i行目の行番号は「i + 2」行目、F列は6列目
sheet.getRange(i + 2, 6).setValue("発行済");

Logger.log("・作成完了: " + docName + " (URL: " + doc.getUrl() + ")");
createdCount++;
}
}

Logger.log("=== 請求書発行処理が正常完了しました(合計: " + createdCount + " 件) ===");
}

コードのポイント解説!

  • generateInvoices() は、スプレッドシートから未発行の請求データを取り出し、1件ずつGoogleドキュメントを新規作成して「御請求書」をレイアウトする関数です。
  • 発行が完了したら、sheet.getRange(i + 2, 6).setValue("発行済") でスプレッドシートのステータスを自動更新し、二重発行を防ぐガードを敷いています。
  • この関数は、単体でエディタから実行することもできますが、今回はこれを「Web画面上のボタンからクリック一発で起動する」のがゴールです!

6. STEP3:【フロント側】index.html にボタンを配置して google.script.run で呼び出そう!

サーバー側の準備ができたので、次はブラウザ画面となる index.html を作成・編集します。
エディタ左側の「+(ファイルを追加)」アイコンから 「HTML」 を選び、ファイル名を index にしてください(すでに存在する場合はそのまま開いてOKです)。

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", sans-serif;
background-color: #f0f4f8;
color: #2d3748;
padding: 40px 20px;
display: flex;
justify-content: center;
align-items: flex-start;
min-height: 100vh;
}
.card {
background-color: #ffffff;
max-width: 600px;
width: 100%;
border-radius: 12px;
box-shadow: 0 8px 20px rgba(0, 0, 0, 0.06);
padding: 32px;
border-top: 5px solid #1a365d;
}
.header {
margin-bottom: 24px;
border-bottom: 1px solid #edf2f7;
padding-bottom: 16px;
}
h1 {
font-size: 20px;
color: #1a365d;
margin-bottom: 6px;
}
.lead {
font-size: 13px;
color: #718096;
line-height: 1.6;
}
.action-box {
background-color: #f7fafc;
border: 1px solid #e2e8f0;
border-radius: 8px;
padding: 24px;
text-align: center;
margin-bottom: 24px;
}
/* アクションボタンのスタイル */
.btn-generate {
background-color: #dd6b20; /* 札幌オータムオレンジ */
color: #ffffff;
font-size: 16px;
font-weight: 700;
padding: 14px 28px;
border: none;
border-radius: 8px;
cursor: pointer;
box-shadow: 0 4px 10px rgba(221, 107, 32, 0.3);
transition: all 0.2s ease;
display: inline-flex;
align-items: center;
gap: 8px;
}
.btn-generate:hover {
background-color: #c05621;
transform: translateY(-2px);
box-shadow: 0 6px 14px rgba(221, 107, 32, 0.4);
}
.btn-generate:active {
transform: translateY(0);
}
/* ボタン無効化(処理中)スタイル */
.btn-generate:disabled {
background-color: #cbd5e0;
cursor: not-allowed;
box-shadow: none;
transform: none;
}
.status-msg {
margin-top: 16px;
font-size: 14px;
font-weight: 600;
min-height: 24px;
}
.info-list {
font-size: 12px;
color: #718096;
line-height: 1.8;
list-style-type: disc;
padding-left: 20px;
}
</style>
</head>
<body>

<div class="card">
<div class="header">
<h1>📑 札幌オフィス 請求書自動発行ポータル</h1>
<p class="lead">スプレッドシートの「未発行」データを読み込み、取引先ごとの請求書Googleドキュメントを一括生成します。</p>
</div>

<div class="action-box">
<!-- クリック時にフロントの JavaScript 関数を実行するボタン -->
<button id="execBtn" class="btn-generate" onclick="onClickGenerateButton()">
<span>⚡ 請求書を一括自動発行する</span>
</button>

<div id="statusMessage" class="status-msg"></div>
</div>

<div>
<p style="font-size: 13px; font-weight: bold; margin-bottom: 8px; color: #4a5568;">【注意事項・仕様】</p>
<ul class="info-list">
<li>スプレッドシートの「発行ステータス」が『未発行』の行のみを対象とします。</li>
<li>発行が完了したデータは、自動的にステータスが『発行済』に更新されます。</li>
<li>作成された請求書ドキュメントは、マイドライブ直下に自動保存されます。</li>
</ul>
</div>
</div>

<script>
/**
* ボタンがクリックされた時にブラウザ側で動く関数
*/
function onClickGenerateButton() {
var btn = document.getElementById("execBtn");
var msg = document.getElementById("statusMessage");

// 1. ボタンを二重押し(連打)できないように無効化する
btn.disabled = true;
btn.innerText = "⏳ 請求書を生成中...";

// 2. 処理中のメッセージを表示
msg.style.color = "#3182ce";
msg.innerText = "Googleサーバーで請求書ドキュメントを作成しています...";

// 3. ★【本日の最重要コード】GASサーバー側の関数を非同期で呼び出す!
google.script.run.generateInvoices();

// 4. コンソールログにも通信開始を記録
console.log("google.script.run.generateInvoices() をリクエストしました。");
}
</script>

</body>
</html>

JavaScript側の動きを1行ずつチェック!

HTMLの末尾にある <script> の中身に注目してください。

  1. btn.disabled = true;
    ボタンをクリックした瞬間にボタンを「灰色(無効化)」にしています。Google側で作成処理が走っている最中に、ユーザーが焦って何回もクリックしてしまうと、同じ請求書が2枚も3枚も複製されてしまう「重複作成バグ」が発生します。これを防ぐための超重要な実務ガードです。
  2. google.script.run.generateInvoices();
    ここが今回のハイライトです!ブラウザがGoogleのクラウドサーバーに向かって、「コード.gs の中にある generateInvoices() という関数を実行して!」と無線で指示を飛ばしています。

7. STEP4:【動作確認】開発用URL(/dev)でボタンを押してみよう!

コードが保存できたら、さっそくテスト用URL(/dev)を使って、Web画面からGASが動く瞬間を体験してみましょう!

  1. GASエディタ右上の青い 「デプロイ」 > 「デプロイをテスト」 をクリックします。
  2. 「ウェブアプリのURL」(末尾が /dev のURL)をコピーします。
  3. ブラウザの新しいタブを開き、貼り付けてアクセスします。

中央にオレンジ色の綺麗なボタン 「⚡ 請求書を一括自動発行する」 が表示されましたね!

ボタンをポチッとクリックしてみる!

ボタンをクリックすると、ボタンが「⏳ 請求書を生成中…」に変わり、文字入力が無効化されます。

ここで、スプレッドシートの画面タブに切り替えて、じっと眺めてみてください……!

数秒後、スプレッドシートのF列(発行ステータス)の「未発行」という文字が、上から順番に「発行済」「発行済」「発行済」と自動で書き換わっていくはずです!

さらにGoogleドライブ(マイドライブ)を開いてみると、

  • 【御請求書】株式会社札幌スープカレー本舗_INV-202610-001
  • 【御請求書】道産子フーズ株式会社_INV-202610-002
  • 【御請求書】北海ITソリューションズ_INV-202610-003

という3通のGoogleドキュメントが、美しい請求書レイアウトでしっかりと生成されていることが確認できます!

ブラウザのWeb画面に置いたボタン1つで、クラウド上のGASが起動し、スプレッドシートを読み取ってドキュメントを生成する——。
Webアプリケーション開発の真髄である「フロントとバックエンドの連携」が、見事に自分の手で実現できた瞬間です!感動的ですよね!

8. STEP5:実務で差がつく!画面の入力値をGASへ渡す応用テクニック

基本が動いたら、実務で絶対に使う応用パターンをマスターしておきましょう!
「決まった処理を一括実行する」だけでなく、「画面上のテキストボックスに入力された文字や、選択されたドロップダウンの値をGASへ渡して処理させる」というテクニックです。

例えば、「発行担当者の名前」を画面の入力フォームから打ち込んでもらい、その名前をGASに受け渡して請求書に印字させてみましょう。

HTML側(入力値の取得と引数渡し)

<!-- 担当者名の入力欄 -->
<label for="issuerName">発行担当者名:</label>
<input type="text" id="issuerName" placeholder="例:札幌 太郎" />

<button onclick="onClickCustomGenerate()">担当者名を指定して発行</button>

<script>
function onClickCustomGenerate() {
// 1. 入力欄からテキストを取得する
var nameInput = document.getElementById("issuerName").value;

if (nameInput === "") {
alert("担当者名を入力してください!");
return;
}

// 2. 引数として変数 nameInput を渡して呼び出す!
google.script.run.generateInvoicesWithIssuer(nameInput);
}
</script>

GAS側(引数の受け取り)

/**
* 引数(issuerName)を受け取るサーバー側関数
*/
function generateInvoicesWithIssuer(issuerName) {
Logger.log("フロントから届いた発行担当者: " + issuerName);

// 請求書作成処理の中で「担当者:〇〇」と書き込む
// doc.getBody().appendParagraph("発行担当者:" + issuerName);
}

このように、google.script.run.関数名(引数1, 引数2...) と書くだけで、ブラウザに入力された値をGoogleサーバーへ何個でも手渡すことができます。
検索フォームやログイン判定、アンケート送信など、あらゆるWebフォーム開発の土台となる必須テクニックです!

9. 初心者が100%つまずく!google.script.run の5大トラップと完全対処法

google.script.run を使い始めた開発者が、必ず一度は頭を抱える「典型的な5大トラップ」を厳選しました。エラーが出たり動かなかったりした時は、まずここをチェックしてください!

トラップ1:戻り値を変数で直接受け取ろうとして undefined になる(非同期の壁)

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

// ✕ 超危険!絶対に動かない書き方
var result = google.script.run.generateInvoices();
console.log(result); // ➔ 必ず「undefined」になる!

【原因】
第2章で解説した通り、google.script.run は「非同期(注文ベル方式)」で動いています。GAS側の処理が完了するのを待たずにブラウザは次の行へ駆け抜けてしまうため、var result = ... と書いても中身は絶対に空っぽ(undefined)になります。

【解決策】
GAS側の関数の戻り値(returnした値)をブラウザで受け取るには、次回(第88回)で解説する .withSuccessHandler(コールバック関数) を使う必要があります。「イコール記号で直接戻り値を受け取ることはできない!」と心に刻んでおきましょう。

トラップ2:<form> タグの中でボタンを押すと画面が勝手にリロードされる

「ボタンを押した瞬間、一瞬だけ動くけど、すぐにWebページ全体が再読み込みされて処理が途中で消えてしまう……」という謎の現象です。

【原因】
HTMLの <form> タグの中に <button> を置くと、ブラウザの仕様で「フォーム送信によるページ更新(リロード)」が標準で発動してしまいます。GASへ電波が届く前にページがリロードされ、通信が切断されてしまうのです。

【解決策】
ボタンの属性に type="button" を明記するか、JavaScript側で event.preventDefault() を呼び出しましょう!

<!-- ◯ 正しい書き方:type="button" を明記する -->
<button type="button" onclick="onClickGenerateButton()">発行する</button>

トラップ3:DOM要素そのものを引数に渡して Exception: Invalid argument

// ✕ エラーになる書き方(HTML要素そのものを渡している)
var inputElem = document.getElementById("issuerName");
google.script.run.saveData(inputElem); // エラー!

【原因と解決策】
第3章のルールでお伝えした通り、HTMLの要素(タグの塊そのもの)はインターネットの電波に乗せてGoogleサーバーへ送ることはできません。必ず .value や .innerText を使って「中に入っている文字列や数値」を取り出してから渡してください!

// ◯ 正しい書き方(中身の文字列を取り出して渡す)
var nameValue = document.getElementById("issuerName").value;
google.script.run.saveData(nameValue);

トラップ4:GAS側の関数名タイポ(大文字・小文字ミス)

JavaScriptは大文字と小文字を厳密に区別します。
コード.gs の関数名が generateInvoices なのに、HTML側で google.script.run.generateinvoices()(全部小文字)と呼ぶと、Googleサーバーは「そんな名前の関数は存在しません」とスルーしてしまい、何も起きません。

「ボタンを押してもウンともスンとも言わないな?」と思ったら、コード.gs の関数名をコピーして、HTML側の google.script.run.〇〇() に貼り付け直してみてください。

トラップ5:エラーが起きていても画面上に何も表示されない!

GASエディタで「実行」を押した時は赤い文字でエラーが表示されますが、Webアプリの画面上で google.script.run を動かした時は、GAS側でエラーが起きてもブラウザの画面には何もエラーが出ません。

【デバッグのコツ】

  1. GAS側の実行数ログを見る:GASエディタの左メニューにある「実行数(再生マーク)」を開くと、裏で動いた関数のログやエラー履歴が赤文字で確認できます。
  2. ブラウザの開発者ツール(F12)を見る:ブラウザで F12キー(Macは Cmd + Option + I)を押して「コンソール(Console)」タブを開くと、JavaScript側のエラーや通信ログが確認できます。

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

今回は、Webアプリの画面からGoogleサーバーのGAS関数を直接呼び出す超重要メソッド google.script.run について徹底解説しました!

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

  1. google.script.run.関数名() で、ブラウザからクラウド上のGASプログラムを遠隔操作できる!
  2. ブラウザ(手元)とGoogleサーバー(雲の上)の役割分担を理解することが成功への第一歩。
  3. google.script.run は「呼び出しベル」のような非同期処理で動くため、画面がフリーズしない。
  4. 引数には文字列、数値、配列、オブジェクトを渡せる(DOM要素や関数は不可)。
  5. 連打による二重実行を防ぐため、ボタンを押した直後に btn.disabled = true; にするのが実務の鉄則!

画面のボタンとGASの処理がガッチャンコと繋がったことで、いよいよ「本物のWebシステム」の領域に足を踏み入れましたね!

🚀 次回予告:処理完了通知とエラー画面制御をマスターしよう!

今回のコードを動かしてみて、ひとつだけ惜しい部分に気づきませんでしたか?
「ボタンを押して請求書が作られたのはいいけれど、画面が『生成中…』のまま止まっていて、いつ終わったのかが画面からはわからない……」という点です。

そこで次回(第88回)は、google.script.run の真の相棒である withSuccessHandler() と withFailureHandler() を徹底解説します!

GAS側で請求書の作成が完了したら、その結果(「合計3件の請求書を作成しました!」)を画面に受け取って完了メッセージを美しく表示したり、万が一エラーが起きたときに親切なエラー画面を出したりする、Webアプリに必須の「双方向コミュニケーション」を完成させます。
次回もお楽しみに!