セットアップ

1. asdfのセットアップ

.tool-versionsに記載されているツールをインストールします。

asdf install

2. claspのグローバルインストール

npm install -g @google/clasp

3. claspのログイン

clasp login

ブラウザが開き、Googleアカウントでログインします。

4. プロジェクトの設定

.clasp.jsonを編集して、scriptIdを設定します。

{
    "scriptId": "<YOUR_SCRIPT_ID>",
    "rootDir": "./"
}

既存のGASプロジェクトのscriptIdを取得するには、以下のコマンドを実行します。

19xxxxxxxxxxxxxJVがscriptIdです。

$ clasp list
*Finding your projects...*
delete email         - https://script.google.com/d/19xxxxxxxxxxxxxJV/edit

既存のGASプロジェクトがない場合は、新しいGASプロジェクトを作成。

clasp create --title <project title>

clasp clone <YOUR_SCRIPT_ID>

開発

1. コードのプッシュ

clasp push

2. 新しいバージョンのデプロイ

clasp deploy

実行

clasp open

GASのコードはWebブラウザで実行できます。GASエディタで対象の関数を選択し、実行ボタンをクリックします。

GASで生成されるファイルと設定情報

コマンド実行後に生成される主なファイル

1. .clasp.json:

clasp cloneまたはclasp createを実行した後に生成されます。このファイルは、Google Apps ScriptのプロジェクトIDとローカルプロジェクトの設定を保持します。

2. appsscript.json:

GASプロジェクトの設定を含むJSONファイル。clasp pullを初めて実行したときにダウンロードされます。

3. .js, .gasファイル:

GASのスクリプトファイル。clasp pullでダウンロードまたはclasp pushでアップロードされます。

4. credentials.json:

（必要な場合）APIを呼び出すための認証情報。手動でダウンロードと配置が必要です。

設定情報

.clasp.json

このファイルは、以下のような形式で設定情報をJSON形式で保持します。

{
    "scriptId": "<YOUR_SCRIPT_ID>",
    "rootDir": "./src",
    "projectId": "<YOUR_GCP_PROJECT_ID>"
}

参考文献

ggoel-apps-script/reference

• https://developers.google.com/apps-script/reference/gmail/gmail-app?hl=ja

Command Line Apps Script Projects

• https://github.com/google/clasp