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


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

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

スクリプトエディタを開いた初期の画面

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

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

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

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

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

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

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

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

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

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

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

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

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

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

スクリプトを保存する

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

スクリプトに未保存の変更がある状態

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

そうなんです。

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

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

スクリプトを保存するにはメニューの「ファイル」→「保存」または「すべてを保存」でもいいですが、ショートカットキーの Ctrl + S または Ctrl + Shift + S(Macの場合は command + S または command + shift + S)で保存をすることができます。

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

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

保存をする際に、プロジェクト名が「無題のプロジェクト」のままだと、以下のように「プロジェクト名の編集」ダイアログが開いて変更するように促されます。

スクリプトエディタでプロジェクト名を編集する

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

今回は「GAS Bots」としておきます。

スクリプトを実行する

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

メニューの「実行」→「関数を実行」から実行する関数名を選択すると実行することができますが、毎回メニュー選択だと面倒なので、ショートカットキーを使う方法もお伝えします。

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

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

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

関数を選択したら、ショートカットキー Ctrl + R(Macの場合は command + R)、またはツールバーの右向き三角アイコンをクリックで実行します。

以下のように「関数myFunctionを実行中…」という表記が出て、すぐに消えます。

スクリプトエディタで実行する関数を選択する
表記が消えたら実行完了ということです。

ログを表示する

何も起きないじゃないか、と思われたかも知れませんが、大丈夫!

慌てずにメニューの「表示」→「ログ」またはショートカットキー Ctrl + Enter(Macの場合は command + Enter)としてみてください。

すると、以下のように「ログ」ダイアログに「Hello GAS!」と表示されているはずです。

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

まとめ

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

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

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

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

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

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

どうぞお楽しみに!

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

Google Apps Script(GAS)をはじめるためのメリットは山程ありますが、何を作ったらいいの?と悩んでしまうこともありますよね。そんな時に、おすすめしたいのが「Bot」の作成です。このシリーズでは、超初心者向けにGASでBotを作る方法を題材としながら、GASプログラミングの一通りの流れと書き方について学んでいきます。
  1. 【初心者向けGAS】本当の最初の一歩!スクリプトエディタでプロジェクトを開く
  2. 【初心者向けGAS】はじめてのスクリプトを作成し、保存し、実行する
  3. 【初心者向けGAS】プログラミングに必須の変数の使い方とデータ型について
  4. 【初心者向けGAS】ログを表示するLogger.logの使い方
  5. 【初心者向けGAS】スクリプト実行時の「承認」でびっくりしないために
  6. 【初心者向けGAS】Spreadsheetサービスの「オブジェクト」の基礎の基礎を知ろう
  7. 【初心者向けGAS】スプレッドシートのシートを取得する2つの方法
  8. 【初心者向けGAS】スプレッドシートのセル・セル範囲とその値を取得する方法
  9. 【初心者向けGAS】for文を使ったスプレッドシートの繰り返しの超基本
  10. 【初心者向けGAS】条件分岐をするif文の使い方の超基本
  11. 【初心者向けGAS】スプレッドシートのセルに値を入力する基礎の基礎
  12. 【初心者向けGAS】条件に応じてループを制御する2つの方法~break文とwhile文~
  13. 【初心者向けGAS】スプレッドシートのセル範囲を行数・列数を使って取得する
  14. 【初心者向けGAS】スプレッドシートのセル範囲をクリアするいくつかの方法
  15. 【初心者向けGAS】Google Apps ScriptでWeb APIを活用するための基礎知識
  16. 【初心者向けGAS】面倒なことはライブラリに任せよう!その概要と追加の方法
  17. 【初心者向けGAS】チャットワークのマイチャットにメッセージを送る最も簡単な例
  18. 【初心者向けGAS】Google Apps Scriptで別の関数を呼び出すfunctionの書き方
  19. 【初心者向けGAS】時限式のイベントトリガーを設置して決まった時刻にBotを送信する方法
  20. 【初心者向けGAS】プロパティストアの概要とスクリプトプロパティの編集方法
  21. 【初心者向けGAS】スクリプトプロパティを操作してそのデータを取り出す方法
  22. 【初心者向けGAS】スプレッドシートのセル範囲の値を二次元配列として取得して取り扱う方法
  23. 【初心者向けGAS】チャットワークのメッセージ記法でBot送信するメッセージを装飾する方法
  24. 【初心者向けGAS】Google Apps Scriptのドキュメンテーションコメントの書き方

  投稿者プロフィール

タカハシノリアキ株式会社プランノーツ 代表取締役
株式会社プランノーツ代表、コミュニティ「ノンプロ研」主宰。1976年こどもの日生まれ。東京板橋区在住。「ITで日本の『働く』の価値を上げる!」をテーマに、VBA&GASの開発、講師、執筆などをしております。→詳しいプロフィールはコチラ
★ご依頼・ご相談はお気軽にどうぞ!→お問い合わせはコチラ
★フォロー頂ければ嬉しいです。

コメント