Google Apps Scriptエディタ完全ガイド：初心者が知っておくべきすべてのこと

Googleドキュメント、Googleスプレッドシート、Googleアナリティクス、GmailなどのGoogleサービスを日常的に使っているなら、Google Apps Scriptを活用することで、これらのサービス同士を連携させ、さまざまな作業を自動化できます。

Google Apps Scriptは、いわば「Google版VBA（Visual Basic for Applications）」と考えると分かりやすいでしょう。Microsoft WordやExcelでVBAを使ってマクロを作成し、操作やタスクを自動化できるように、Google Apps ScriptではGoogle各サービスにまたがるタスクやアクションを自動化できます。さらに、スプレッドシートやドキュメントでは、独自のカスタムメニューを作成することも可能です。

この記事では、各GoogleサービスでApps Scriptにアクセスして有効化する方法、Apps Scriptエディタの操作方法、そしてサービス同士を連携させる方法を解説します。具体的なスクリプト関数については触れませんが、Googleが提供する充実した公式ドキュメントやチュートリアルを活用すれば、Apps Scriptの書き方をしっかり学べます。

Google Apps Scriptエディタへのアクセス方法

Google Apps Scriptのコードエディタは、複数のGoogleサービスから開くことができます。たとえば、Googleスプレッドシートの場合は、拡張機能メニューの中にApps Scriptがあります。

その他のサービスでは、以下の方法でエディタを開けます。

• Googleドキュメント：「ツール」メニューから「スクリプトエディタ」を選択
• Googleスライド：「ツール」メニューから「スクリプトエディタ」を選択
• Googleフォーム：右上の3点メニューから「スクリプトエディタ」を選択
• Googleドライブ：画面の空白部分を右クリックし、「その他」→「Google Apps Script」を選択

いずれの方法でも、新しいタブでApps Scriptコードエディタが開きます。ここが、スクリプト全体を構成する各関数を記述していく作業画面です。デフォルトでは、空の関数「myFunction()」が表示されており、すぐにコードの記述を始められる状態になっています。

注意：エラーを避けるためには、コードの書式（インデントなど）が非常に重要です。また、後述のコード例のようにコメントを活用して、コードの各区画で何をしようとしていたのかを自分用のメモとして残しておくとよいでしょう。これは、WebプログラミングにおけるHTMLのコメント機能とよく似ています。

コードエディタ内を移動しているときは、左側のナビゲーションペインにあるエディタウィンドウの「Code.gs」を選択すれば、いつでもこの画面に戻れます。他のウィンドウを表示したい場合は、左端のアイコンにカーソルを合わせるとメインのナビゲーションペインが展開されます。

概要（Overview）セクションでは、スクリプトに関する統計情報を確認できます。発生したエラーの数や実行回数などがここに表示されます。

それ以外のセクションについては、以下で順番に詳しく見ていきましょう。

Google Apps Scriptエディタの操作方法

エディタでコードを編集する際は、こまめに保存（フロッピーディスクのアイコン）をクリックして、作業内容を失わないようにしましょう。

保存すると、他のメニューオプションが有効になります。

これらのオプションには以下のようなものがあります。

• 実行：スクリプト全体を最初から最後まで実行します。
• デバッグ：スクリプトを1行ずつステップ実行して動作を確認します。
• 関数のプルダウン：作成済みの関数を一覧表示し、目的の関数へ移動できます。
• 実行ログ：スクリプトを実行するたびに、ステータスやエラーメッセージを確認できます。

左側ナビゲーションメニューのライブラリオプションでは、他の人が作成したライブラリ（または自分が別の場所で作成・保存したライブラリ）にアクセスできます。たとえば、友人がすでにGoogleスプレッドシートやGoogleドキュメント向けの便利な機能を作っていて、それをベースに独自の機能を追加したい場合などに役立ちます。

ライブラリをプロジェクトに追加するのに必要なのは「スクリプトID」だけです。スクリプトIDはプロジェクト設定セクションで確認でき、その探し方は記事の最後で紹介します。

Google Apps Scriptのサービス（アドオン）連携

サービスセクションは最も実用的な機能の一つです。ここでは、現在作成中のスクリプトを、自分が利用している他のGoogleサービスと統合できます。

サービスを選択すると、「サービスを追加」というウィンドウが開きます。既存のプロジェクトにアドオンとして追加したいサービスを探して選びましょう。

たとえば、Googleアナリティクスのデータをこのスクリプトに取り込みたい場合は、「Google Analytics API」を選択して「追加」をクリックします。

新しく追加したサービスで利用できる関数の詳細や使い方を知りたい場合は、APIの右側にある3点メニューから「ドキュメントを表示」を選択してください。

すると、新しいタブでGoogle Apps Scriptのドキュメントが開き、自動的に該当するGoogleサービスのセクションへ移動します。

ドキュメントには関数の構文、チュートリアル、コード例が掲載されているので、自分のスクリプトにそのまま活用できます。

また、ドキュメントの他のセクションも参照してみましょう。最初にApps Scriptコードエディタを開いたサービスに基づいて、スクリプトで利用できる汎用関数を確認できます。

たとえば、Googleスプレッドシートでエディタを開いた場合は、ドキュメントメニューの「スプレッドシート」セクションをチェックすると、スクリプトで使用可能なGoogleスプレッドシート関連の関数がわかります。

Apps Scriptトリガーの設定と活用

Google Apps Scriptのもう一つの便利な機能が、さまざまなイベントやスケジュールに基づいてトリガーを設定できる点です。

スクリプトに新しいトリガーを設定するには、左端のナビゲーションメニューから「トリガー」を選択します。開いたトリガー画面で「トリガーを追加」ボタンをクリックしましょう。

トリガー追加ウィンドウには多くのオプションが並んでおり、スクリプトをどのように、いつ実行するかを細かくカスタマイズできます。

注意：これらのオプションの多くは、スクリプトの対象となるサービスや、追加したAPIによって異なります。

トリガーを設定するには、以下の項目を選択する必要があります。

• 最初に起動する関数
• イベントソース（特定の日時、またはスプレッドシートのセル変更やドキュメントの初回オープンなど、サービス内のイベント）
• イベントタイプ（スプレッドシートやドキュメントが開かれたとき・編集されたとき、または日付・時刻の詳細設定）
• 通知頻度（スクリプトが失敗した際の通知を受け取る頻度）

「保存」をクリックすると、初めて新しいトリガーを保存する場合には「スクリプトの承認に失敗しました」というメッセージが表示されることがあります。

これは通常、ブラウザでポップアップブロックが有効になっていることが原因です。Google Chromeを使用している場合は、赤い「×」が付いた小さなウィンドウアイコンをクリックし、設定を「常にポップアップを許可」に変更して「完了」を選択しましょう。

再度「保存」をクリックすると、作成したスクリプトを自分のGoogleアカウントまたはGoogle Workspaceで実行するための承認プロセスに進みます。

まず、スクリプトの実行を許可するGoogleアカウントを選択してください。

次に、作成したカスタム関数やスクリプトがGoogleによって「未確認」であるという警告が表示されます。自分で書いたスクリプトであれば、この警告は問題ないので、自分のGoogleアカウントやGoogle Workspaceで実行しても安全です。

この警告をスキップするには、「詳細」を選択し、下部にある「<プロジェクト名>（安全ではないページ）に移動」というリンクをクリックします。

最後に、権限の確認画面で「許可」を選択すれば、カスタム関数とスクリプトがGoogleアカウントまたはGoogle Workspaceで実行できるようになります。

この承認プロセスは、初めてカスタムGoogle Apps Scriptプロジェクトを保存・実行するときにのみ必要で、以降は繰り返す必要がありません。

スクリプトIDの確認方法

最後に一つ補足です。作成したスクリプトを友人や同僚に共有して、使ってもらったり、彼らのスクリプトにライブラリとして組み込んでもらったりしたい場合があるでしょう。

スクリプトIDは、左端のナビゲーションペインにある設定（歯車）アイコンから確認できます。

スクリプトIDは「ID」セクションの「スクリプト ID」の右側に表示されています。

ご覧のとおり、各機能へのアクセス方法さえ把握していれば、Google Apps Scriptエディタはとても直感的に操作できます。あとはGoogleのApps Script公式ドキュメントをしっかり学んで、スクリプトの書き方や利用可能なすべての関数をマスターしていきましょう。