このページは Cloud Translation API によって翻訳されました。

clasp でコマンドラインインターフェースを使用する

ターミナルではなく、ターミナルから Apps Script プロジェクトを開発、管理するには、 Apps Script エディタでは、clasp というオープンソースツールを使用できます。

clasp Codelab では、 clasp の機能。

機能

ローカルで開発する

clasp を使用すると、Apps Script プロジェクトをローカルで開発できます。Google Chat では自分のパソコンでコードを記述して、いつでもどこでもできます。既存の Apps Script プロジェクトをダウンロードして、編集することもできます。オフラインでも表示できます。コードはローカルなので、好みのものを使用して Apps Script のビルド時に使用する git などの開発ツールできます。

デプロイのバージョンを管理する

マルチイベントの作成、更新、表示 Deployment を表します。

コードを構造化する

clasp を使用すると、保持されるディレクトリにコードを整理できるアップロードする際に使用します次に例を示します。

# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs

# Locally:
├── tests/
│   ├─ slides.gs
│   └─ sheets.gs

要件

clasp は Node.js で記述され、以下を介して配布されます。 npm ツール。clasp を使用するには、次の要件を満たしている必要があります。 Node.js バージョン 4.7.4 以降がインストールされていること。 Node.js のインストールには管理者権限が必要です。

インストール

Node.js をインストールしたら、次の npm コマンドを使用して次のことを行えます。 clasp をインストールします。

npm install @google/clasp -g

インストール後、次の任意のディレクトリから clasp コマンドを使用できます。ダウンロードします。

`clasp` の使用

clasp を使用すると、コマンドラインからさまざまなタスクを処理できます。このセクションでは、clasp を使用して開発する際に使用できる一般的なオペレーションについて説明します。

このコマンドを実行すると、ログインして Google アカウントの定義できます。実行すると、Google Cloud コンソールへのログインを管理する方法です。

clasp login

ログアウト

このコマンドは、コマンドラインツールからログアウトします。次を使用して再ログインする必要があります: 引き続き clasp を使用するには、clasp login で Google での再認証を行ってください。

clasp logout

新しい Apps Script プロジェクトを作成する

このコマンドは、現在のディレクトリに新しいスクリプトを作成します。オプションのスクリプトのタイトル。

clasp create [scriptTitle]

このコマンドは、現在のディレクトリに 2 つのファイルも作成します。

スクリプト ID を格納する .clasp.json ファイル。
プロジェクトメタデータを含む appsscript.json プロジェクトマニフェストファイル。

既存のプロジェクトのクローンを作成する

このコマンドは、現在のディレクトリに既存のプロジェクトのクローンを作成します。スクリプト Google アカウントで作成または共有する必要があります。スクリプトを指定するスクリプト ID を指定してクローンを作成します。

プロジェクトのスクリプト ID を確認する手順は次のとおりです。

Apps Script プロジェクトを開きます。
左側にある [プロジェクトの設定] をクリックします。
[ID] で、スクリプト ID をコピーします。
```
 clasp clone <scriptId>
```

スクリプトプロジェクトをダウンロードする

このコマンドを実行すると、Apps Script プロジェクトが Google ドライブからダウンロードされます。

clasp pull

スクリプトプロジェクトをアップロードする

このコマンドは、スクリプトプロジェクトのすべてのファイルをパソコンから Google ドライブ。

clasp push

プロジェクトバージョンを一覧表示する

このコマンドを実行すると、スクリプトプロジェクトの各プロジェクトの番号と説明があります。

clasp versions

公開済みのプロジェクトをデプロイする

スクリプトプロジェクトは、ウェブアプリ、アドオン、実行可能ファイルとしてデプロイできます。Google Chat ではスクリプトエディタでデプロイメントを作成するプロジェクトのマニフェストで宣言するか、clasp を使用します。

clasp を使用してプロジェクトをデプロイするには、まず不変バージョンのアプリを作成します。スクリプトプロジェクト。バージョンは「スナップショット」スクリプトプロジェクトのものとほぼ同じです。ブランチ型リリースになります

clasp version [description]

このコマンドにより、新しく作成されたバージョン番号が表示されます。この番号を使用して、を使用して、プロジェクトのインスタンスをデプロイおよびデプロイ解除できます。

clasp deploy [version] [description]
clasp undeploy <deploymentId>

このコマンドは、既存のデプロイメントを新しいバージョンと説明で更新します。

clasp redeploy <deploymentId> <version> <description>

デプロイのリスト表示

このコマンドは、スクリプトプロジェクトのデプロイ ID、バージョン、説明します。

clasp deployments

Apps Script エディタでプロジェクトを開く

このコマンドにより、Apps Script エディタでスクリプトプロジェクトが開きます。エディタはデフォルトのウェブブラウザの新しいタブとして起動します

clasp open

`clasp` オープンソースプロジェクトへの貢献

GitHub で clasp に貢献します。

clasp でコマンドライン インターフェースを使用する

機能