【GAS】Hello Worldからスプレッドシート実行まで：環境構築と権限承認の勘所

Google Apps Script（GAS）の学習は、ブラウザひとつで完結する手軽さが魅力です。まずは基本中の基本である「Hello World」の出力から、実用的な「スプレッドシート上のボタン実行」までの最短ルートを整理してみましょう。

1. ログ出力（Hello World）：最小構成での動作確認

プログラミングの第一歩は、正しく環境が動いているかを確認することです。まずはコンソールへの出力から始めます。

[ 手順 ]：
1. シート新規作成：[sheets.new] 等で新しいスプレッドシートを作成する。

2. エディタ起動：[拡張機能] ＞ [Apps Script] を選択する。

3. コード入力：function helloWorld() { console.log('Hello World'); } と記述。

4. 保存と実行：プロジェクトを保存し、[実行] ボタンをクリックする。

5. 結果確認：実行ログに「Hello World」と表示されることを確認する。

2. シート操作と権限：Googleの「承認の壁」を突破する

ポイント：初回実行時のセキュリティ警告は「詳細」から進む

セルへの書き込みを行う際は、Googleアカウントへのアクセス許可が必要です。「確認されていません」という警告が出た際の正しい突破手順を把握しておきましょう。

[ 承認フロー ]：
1. コード追記：function writeToSheet() { SpreadsheetApp.getActiveSheet().getRange("A1").setValue("Hello World"); } を追加。

2. 実行：関数を選択して [実行] をクリック。

3. 警告対応：[権限を確認] ＞ アカウント選択 ＞ [詳細] をクリック。

4. 許可：最下部の [（プロジェクト名）に移動（安全ではない）] ＞ [許可] を選択。

5. 目視確認：スプレッドシートのA1セルに文字が書き込まれたことを確認する。

3. ボタン実行の実装：UIへのスクリプト割り当て

開発画面を開かずに実行できるよう、シート上の図形にスクリプトを紐付けます。

[ ボタン化の構成図 ]

Step.1: 図形の挿入
[挿入] ＞ [図形描画] からボタンを作成し、[保存して終了]。

Step.2: 関数の割り当て
図形を右クリック ＞ [︙] ＞ [スクリプトを割り当て] を選択。
カッコなしの関数名 writeToSheet を入力。

Step.3: 実行状態の解除
一度セルをクリックして選択を解除してから、ボタンを左クリック。

Step.4: 最終確認
画面上に「実行しています」と出て、A1セルが更新されることを確認。

4. なぜ「保存場所」の理解が必要なのか？

1. 実体の基準: 作成したスクリプトは、スプレッドシート本体に紐付いた「コンテナバインド・スクリプト」として管理されます。
2. ファイル管理: Googleドライブ内のシートと同じ場所に存在し、独立した拡張子（.gs）ファイルとして単体で表示されることはありません。
3. コピーの挙動: シートをコピーすれば中のコードも同期してコピーされるため、ツール配布が非常にスムーズです。