【初心者向け】初めてのGoogle Apps Script(GAS)コーディング【ログ出力】

初めてGASでコーディングする人向けにまずは基礎中の基礎、「ログの出力」をやっていきます。ログとはスクリプトの実行の結果のことを指しています。利用シーンとしては、開発中にここまでの処理でどんな結果が得られているのかを確認したり、何かバグがあったときになぜそのバグが起こるのか原因調査したりと様々。GASをやっていく中では不可避なものなので、ここでマスターしてしまいましょう。

※ この記事は「【初心者向け】非エンジニアがGASを始める最初の一歩【まずは5分だけでOK】」を前提にして話を進めていきます。

GASでログの出力をやってみる

スクリプトエディタを開いて実際に作業をしていきましょう。

スクリプトファイルを作成する

テスト用のスクリプトファイルを作ってみましょう。スクリプトエディタの上部メニューの「ファイル」をクリック。その中の「新規作成」→「スクリプト ファイル」をクリックしてください。するとファイル名を聞かれるので任意の名前を入力してください。ここでは「test」と入力しました。

こんな感じですね。

GAS関数の基礎

テスト用のスクリプトファイルができたら次は関数を作っていきましょう。そもそも「関数」とはというところですが、関数というのは簡単に言うと料理のレシピのようなものです。関数はいつも「引数」という概念とセットになっています。関数が料理のレシピで「どんな方法で調理をしていくか」を表現しており、引数が料理の材料というようなイメージです。

カレー関数に肉と野菜とルーを引数にして実行するとカレーが出来上がる、そんな風に考えて貰えれば大体OKです。

話をGASに戻しますが、GASの関数は必ず下のような形になります。

関数名はどんなことをやる関数なのかがわかるように命名しましょう。GASでは命名時に「checkGmail」のように最初は小文字で始めるけれど、次の単語の頭文字を大文字にしたりします。

引数は関数の中で使う材料です。複数使うこともできその場合は「,」（コンマ）で区切ります。引数がない場合が中身を空にすることもできます（括弧は消さないでください）。

{}の中には実行していく処理を書いていきます。おいおい勉強をしていきましょう。

ログを出力してみる

ではいよいよログを出力してみましょう。まずはサンプルコードを見てみてください。

ログを出力するには「Logger」を使います。「Logger.log()」として実行すると、括弧内のものがログとして出力されます。

こんな感じで上のサンプルコードをコピーして関数を手動実行してみましょう。手動実行は実行したい関数をプルダウンから選択肢して三角の再生ボタンをクリックです。

手動実行できたら、実際にログを確認してみましょう。「表示」→「ログ」とクリックしてください。下の図のように表示されていれば完璧です。

これでログの出力は終わりです。現段階では何の役に立つかイメージしにくいかもしれないですが、GAS開発でよく使うのでしっかり抑えておきましょう。

実践ではサンプルコードのように文章を入れることはなくて、下のコードのように変数の中身をチェックしたりします。詳しいことは今後の記事の中で扱っていきます。

Googleアプリを仕事で使うなら「G Suite」がおすすめ