【初心者向けGAS】はじめてのスクリプトを作成し、保存し、実行する

Google Apps Script

photo credit: DaveBleasdale HERE via photopin (license)

2018.03.122021.04.18

script-create

photo credit: DaveBleasdale HERE via photopin (license)

みなさん、こんにちは！
タカハシ(@ntakahashi0505)です。

Google Apps Scriptの超入門ということで、簡単なBotの作り方を学びながら、GASプログラミングの流れと基礎についてシリーズでお伝えしています。

前回の記事はこちらです。

【初心者向けGAS】本当の最初の一歩！スクリプトエディタでプロジェクトを開く

超初心者向けにGoogle Apps Scriptのプログラミングの一通りの流れと書き方について学ぶシリーズです。今回は、その最初の一歩としてスプレッドシートからスクリプトエディタを開く手順をお伝えします。

GASプログラミングをするためのスクリプトエディタの開き方についてお伝えしました。

さて、今回はその続きとして、スクリプトと変数の使い方を学ぶだけの超簡単なGASプログラミングを体験していただきます。

Google Apps Scriptで初めてのスクリプトを作成し、保存し、実行する方法です。

では、行ってみましょう！

目次

関数とfunction
ステートメントを記述する
スクリプトを保存する
プロジェクト名を変更する
スクリプトを実行する
ログを表示する
まとめ
連載目次：超初心者向けGASでBotを作りながら基礎を学ぶ

関数とfunction

スクリプトを新規で開くと、以下のような画面になりますね。

デフォルトで以下のようなスクリプトが、すでに書き込まれているはずです。

function myFunction() {
  
}

これは、「myFunction」という名前の関数です。

関数というのは、一連の処理をまとめたものに名前をつけたもので、スクリプトの実行単位となります。

関数を定義する場合は、上記のようにfunctionキーワードを使い以下のように記述します。

function 関数名() {
　//処理
}

波括弧（{}）の間をブロックといい、その間にその関数名でまとめたい処理を記述します。

ステートメントを記述する

ただ、上記の関数には、何の命令も記載されていませんので、実行しても何も起きません。

なので、以下のように間に一行だけ処理を書いてあげましょう。

function myFunction() {
  console.log('Hello GAS!');
}

コードエリアはエディタやWordと同じような操作でコードを編集できますので、試してみてください。

「console.log(‘Hello GAS!’);」という命令を追加しましたが、命令の一つ一つをステートメントといいます。

GASでステートメントを記述する際には、以下はルールとなっていますので、守るようにしましょう、

ステートメントの最後にはセミコロン(;)を記述する
命令は大文字・小文字が厳密に区別されています

つまり、「console」を「Console」と書いたり、「log」を「Log」と書いてはいけません。

スクリプトを保存する

上記のスクリプトを入力した段階で、以下のように「コード.gs」という表記の隣りに黄色い丸マークがつくはずです。

これは、「未保存の変更がある」ということを表すマークです。

そうなんです。

スプレッドシートやドキュメントと異なり、GASのスクリプトは自動保存ではありません。

したがって、変更をした際にはスクリプトの保存をする必要があります。

スクリプトを保存するにはショートカットキーの Ctrl + S （Macの場合は ⌘S ）で保存をすることができます。

なお、ツールバーのディスクアイコンをクリックでも保存をすることができますよ。

プロジェクト名を変更する

プロジェクトには、プロジェクト名があります。

プロジェクト名が「無題のプロジェクト」のままだと管理しづらいので変更をしておきましょう。

以下のように、プロジェクト名をクリックすると「プロジェクトの名前を変更」ダイアログが開きます。

プロジェクト名は何でも良いですが、プロジェクトの内容がわかりやすいものが良いでしょう。

今回はプロジェクト名を「GAS Bot」として、「名前を変更」としておきます。

スクリプトを実行する

前述の通り、GASのスクリプトは関数単位で実行します。

まず、ツールバーに「myFunction」とありますが、ここはプルダウンになっていて、現在のスクリプトファイルに入力されているすべての関数がリストされます。

このプルダウンで実行したい関数を選択しましょう。

今回は、「myFunction」しかありませんが、ファイルに複数の関数を入力している時には、目的の関数を選択しておく必要がありますので、忘れずにどうぞ。

関数を選択したら、ショートカットキー Ctrl + R（Macの場合は ⌘R ）、またはツールバーの「▷実行」をクリックで実行します。

すると、以下のように「実行ログ」が画面下部に表示され、その中に「Hello GAS!」との表示を見つけることができるはずです。

今回作ったコードは「ログ」を表示するスクリプトだったんですね。

まとめ

以上、Google Apps Scriptでスクリプトを作成する、保存する、実行する方法についてお伝えしました。

それほど難しいそうさはなかったと思いますが、

関数は一連の処理をまとめた実行単位でfunctionキーワードを使って宣言
ステートメントの最後にはセミコロンが必要
大文字・小文字は注意
スクリプトは保存が必要

など、重要なことがいくつかありましたので、ぜひ頭に入れておいて下さいね。

次回は、ログ出力と変数の使い方について詳細をお伝えします。

【初心者向けGAS】プログラミングに必須の変数＆定数の使い方とデータ型について

Google Apps Scriptの超入門ということで、GASプログラミングの基礎中の基礎を学んでいくシリーズです。今回、プログラミングで重要なテクニックである変数＆定数の使い方とデータ型についてお伝えします。

どうぞお楽しみに！

連載目次：超初心者向けGASでBotを作りながら基礎を学ぶ

Google Apps Script（GAS）をはじめるためのメリットは山程ありますが、何を作ったらいいの？と悩んでしまうこともありますよね。そんな時に、おすすめしたいのが「Bot」の作成です。このシリーズでは、超初心者向けにGASでBotを作る方法を題材としながら、GASプログラミングの一通りの流れと書き方について学んでいきます。

タイトルとURLをコピーしました