Google Apps Script Editor：始めるために知っておくべきことすべて

Googleドキュメント、Googleスプレッドシート、Google Analytics、GmailなどのGoogleサービスを使用している場合は、GoogleAppsScriptを使用してこれらのサービスに接続して自動化できます。

Google Apps Scriptは、GoogleバージョンのMicrosoftのVBAスクリプトのように考えてください。 VBAを使用してMicrosoftWordおよびExcelでアクションとタスクを自動化したり、マクロをカスタマイズしたりできるのと同じように、Googleサービス全体でタスクとアクションを自動化できます。スプレッドシートやドキュメントなどのサービスでは、独自のカスタムメニューを作成することもできます。

この記事では、さまざまなGoogleサービスでApps Scriptにアクセスして有効にする方法、Apps Script Editorをナビゲートする方法、およびサービスを接続する方法について学習します。特定のスクリプト機能については学習しませんが、Googleには、AppsScriptの記述方法を学習するための優れたドキュメントとAppsScriptチュートリアルが用意されています。

Google AppsScriptEditorにアクセスする方法

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

他のサービスでは、次の方法でGoogle AppsScriptEditorを開くことができます。

• Googleドキュメント ：スクリプトエディタを選択します ツールで メニュー。
• Googleスライド ：スクリプトエディタを選択します ツールで メニュー。
• Googleフォーム ：スクリプトエディタを選択します 3ドットメニューで。
• Googleドライブ ：空白スペースを右クリックして、その他を選択します 、 Google Apps Scriptを選択します 。

これらの方法のいずれかを使用すると、AppsScriptコードエディタが新しいタブで開きます。これは、スクリプト全体を構成する各関数を作成するウィンドウです。デフォルトでは、myFunction（）という名前の空の関数が表示され、コードの入力を開始する準備ができています。

注 ：エラーを回避するには、コードのフォーマットが非常に重要です。次のコードに示すようにコメントを使用して、コードのセクション内で何をしようとしていたかを思い出してください。これは、Webプログラミングを使用したHTMLコードでのコメントの動作と非常によく似ています。

コードエディタをナビゲートしているときに、 Code.gs を選択すると、このセクションに戻ることができます。 エディタの左側のナビゲーションペイン 窓。他の利用可能なウィンドウを表示するには、左端のペインのアイコンにカーソルを合わせると、メインのナビゲーションペインが開きます。

概要 セクションでは、発生したエラーの数、実行された回数など、スクリプトに関する統計を見つけることができます。

以下の各セクションでは、GoogleAppsScriptエディタの他の各セクションについて説明します。

Google AppsScriptEditorの操作

エディターでコードを編集するときは、作業内容を失わないように、ディスク（保存）アイコンを頻繁に選択することをお勧めします。

保存すると、他のメニューオプションが点灯します。

これらには以下が含まれます：

• 実行 ：スクリプト全体を最初から最後まで実行してみてください。
• デバッグ ：スクリプトを一度に1行ずつ進めます。
• 関数のドロップダウン ：作成した各関数を参照して移動します。
• 実行ログ ：スクリプトの実行を試行するたびに、ステータスまたはエラーメッセージが表示されます。

ライブラリ 左側のナビゲーションメニューのオプションでは、他の人が作成した（または他の場所で作成して保存した）ライブラリにアクセスできます。これは、GoogleスプレッドシートやGoogleドキュメントで使用したい機能をすでに作成している友人がいて、その上に機能を追加したい場合に便利です。

これらのライブラリをプロジェクトに追加するために必要なのは、スクリプトIDだけです。これは、この記事の最後にあるプロジェクト設定セクションで見つけることができます。

Google AppsScriptServicesアドオン

サービス セクションが最も便利です。ここで、現在のスクリプトを、使用する可能性のある他のGoogleサービスと統合できます。

選択すると、サービスの追加が表示されます ウィンドウが開きます。既存のプロジェクトへのアドオンとして使用するサービスまで下にスクロールします。

たとえば、Googleアナリティクスアカウントからこのスクリプトにデータを取り込む場合は、GoogleアナリティクスAPIを選択できます。 、[追加]を選択します 。

その新しいアドオンサービスで使用できる関数とその使用方法の詳細を知りたい場合は、APIの右側にある3つのドットを選択し、ドキュメントを参照を選択してください。 。

これにより、Google Apps Scriptのドキュメントが新しいタブで開き、そのGoogleサービスのセクションが自動的に開きます。

独自のスクリプトで使用できる関数の構文、チュートリアル、コード例については、ドキュメントをご覧ください。

また、ドキュメントの他のセクションに移動して、AppsScriptコードエディタを最初に開いたときに使用していたサービスに基づいてスクリプトで使用できる一般的な機能を確認できることにも注意してください。

たとえば、Googleスプレッドシートでエディタを開いた場合は、スプレッドシートを確認してください スクリプトで使用できるGoogleスプレッドシート機能のドキュメントメニューのセクション。

AppsScriptトリガーの設定と使用

Google Apps Scriptのもう1つの便利な機能は、多数のイベントやスケジュールに基づいてトリガーを設定する機能です。

スクリプトの新しいトリガーを構成するには、トリガーを選択します 左端のナビゲーションメニューから。開いた新しいトリガーウィンドウで、トリガーの追加を選択します ボタン。

[トリガーの追加]ウィンドウには、スクリプトを実行する方法とタイミングを正確にカスタマイズするのに役立つオプションの長いリストがあります。

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

トリガーを設定するには、次を選択する必要があります：

• 最初に起動する機能
• 特定の時刻、日付、またはGoogleスプレッドシートのセルが変更されたときやドキュメントが最初に開かれたときなど、サービス内のイベントなどのイベントソース
• Googleスプレッドシートやドキュメント内の何かが開かれたり編集されたりしたときなどのイベントの種類、または日付や時刻の特定の設定
• スクリプトが失敗したときの更新を取得する頻度の通知頻度

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

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

保存を選択した場合 繰り返しになりますが、作成したスクリプトをGoogleアカウントまたはGoogleWorkspaceで実行することを承認するプロセスをステップスルーする必要があります。

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

作成したカスタム関数またはスクリプトがGoogleによって「検証」されていないという警告が表示されます。スクリプトを作成した人であれば、これは問題ではなく、自分のGoogleアカウントまたはGoogleWorkspaceで実行しても安全です。

この警告を回避するには、詳細を選択するだけです。 次に、 [<プロジェクト>に移動（安全ではない）]を選択します 下部にあるリンク。

最後に、権限ウィンドウで、[許可]を選択します カスタム関数とスクリプトをGoogleアカウントまたはGoogleWorkspaceで実行できるようにします。

このプロセスを再度繰り返す必要はありません。カスタムのGoogleAppsスクリプトプロジェクトを初めて保存または実行する場合に限ります。

GoogleScriptIDへのアクセス

最後に、友人や同僚がスクリプトを使用するか、ライブラリとして自分のスクリプトに追加できるように、スクリプトを提供することをお勧めします。

スクリプトIDは、左端のナビゲーションペインの[設定]アイコンにあります。

スクリプトIDは、 IDの下にあります。 スクリプトIDの右側のセクション 。

ご覧のとおり、使用する各機能に移動する方法を知っていれば、GoogleAppsScriptエディタはかなり簡単です。スクリプトと使用可能なすべての関数の記述方法を学び始めることができるように、GoogleのAppsScriptドキュメントをよく調べてください。