【GAS】Google Apps Scriptの基本的な使い方・始め方

Googleアカウントの準備#

まず、Googleアカウントが無いと何も始まらないので、準備しておきましょう。

Google Apps Scriptのプロジェクトの作成#

GASを使うために、GASのプロジェクトを作成する必要があります。

以下の手順で作っていきます。

1. スプレッドシート、ドキュメント、スライドの編集画面から、拡張機能＞Apps Scriptの順で、スクリプトエディタを起動します。（GASのトップ画面から新規作成したり、Googleドライブから新規作成すると、スプレッドシート等のファイルに紐付かなくなるので、編集画面から作成します。）
2. スクリプトエディタが開いたら、プロジェクト名を入力し、OKボタンをクリックします。
3. デフォルトでコード.gsというファイルが作成されます。このファイルにJavaScriptコードを記述していきます。

コードの実行#

そしたら、スクリプトエディタに、JavaScriptのコードを記述します。 コードを少し書いたら、スクリプトエディタのツールバーにある実行ボタンをクリックするか、ショートカットキー（Ctrl + Enter）を押してコードを実行します。

1
function myFunction() {
2
  console.log("hello, world.");
3
}

無事に実行が完了して、下方にログが表示されたことが確認できます。

Googleサービスとの連携#

Google Apps Scriptでは、Google Apps Scriptのサービス（ScriptPropertiesやHtmlService）や、Google Apps Scriptがサポートする他のGoogleのサービス（Gmail、Googleスプレッドシートなど）のオブジェクトを使用して、様々な操作を行うことができます。

そして、それらのGoogleのサービスを使用するためには、Google Cloudにもプロジェクトを作成した方が良いです。作成しないでコードの作成を進めていくと、いずれ途中で権限に引っ掛かってコードを実行することが出来なくなります。

まだGoogle Cloudにプロジェクトを作成していない場合は、プロジェクトを作成したいGoogleアカウントでログインしている状態で、下記のサイトから右上のコンソールをクリックしてプロジェクトを作成します。

Google Cloud

AI とクラウド コンピューティング サービス

セキュリティ、データ管理、ハイブリッド クラウドとマルチクラウドなど、Google の AI とクラウド コンピューティング サービスを活用して、ビジネス上の課題に正面から取り組みましょう。

cloud.google.com

Google Cloudのコンソールに移動したら、新しいプロジェクトを作成していきます。

以下のような画面が表示されたら、プロジェクト名およびプロジェクトIDを設定していきます。何かしらの組織に属しているアカウントであれば、組織も設定できるでしょう。（上のタスクバーはデフォルトは白色です。拡張機能を入れているため白色ではありません。）

プロジェクトが作成できると、以下のようなプロジェクトのトップ画面が表示されます。ここで表示されている、プロジェクト番号をメモしておきます。

そして、そのプロジェクト番号を、GASのスクリプトエディタ画面内のサイドバーにあるプロジェクトの設定をクリックして、表示された画面内のGoogle Cloud Platform（GCP）プロジェクトのセクションで、プロジェクトを変更をクリックして先程メモしたプロジェクト番号を入力します。

これで、他の各種Googleサービスを利用しやすくなりました！

これからのコード実行時に、Googleサービス利用するようにコーディングしていると、権限の認証をするウインドウが表示されることがあると思います。この権限の認証をすれば、Googleサービスを使えるようになるというわけです。

ちなみに、先程実行したコードではログを表示する処理を行いましたが、Google Cloudのプロジェクトに紐付けることで、そのログをそのプロジェクト内のロギングという機能で、いつでも確認することが出来るようになります。そして、この後に紹介するトリガー機能で自分が見ていない時に実行された関数のログを後で確認することが可能なわけです。

Googleサービスの利用#

それでは試しに、Googleスプレッドシート内のセルに任意の文字列を記入したいと思います。

1
function myFunction() {
2
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
3
  const sheet = spreadsheet.getActiveSheet();
4
  sheet.getRange("A1").setValue("Hello, World!");
5
}

コードを実行すると、権限の認証をすることになります。 表示されたウインドウ内の「詳細を表示」をクリックして、「（安全ではないページ）に移動」をクリックして、認証をします。

権限が認証できると、コードが実行されて、Googleスプレッドシートに「Hello, World!」が入力されていることが確認できます。