Apps Script プロジェクトのデプロイは、ウェブアプリ、アドオン、API 実行可能ファイルとして使用できるようにしたスクリプトのバージョンです。デプロイを作成して管理することで、コードを反復処理し、変更を追跡し、ユーザーがアクセスできるコードの正確なバージョンを制御できます。
デプロイには次の 2 種類があります。
- ヘッドデプロイ。常に現在のプロジェクト コードと同期されます。
- バージョン付きデプロイ: 特定のプロジェクト バージョンに接続されます。
ヘッドデプロイ
ヘッド デプロイは現在のプロジェクト コードです。Apps Script プロジェクトを作成すると、そのプロジェクトのヘッド デプロイが自動的に作成されます。
ヘッド デプロイは、最後に保存されたコードと常に同期しています。たとえば、バージョン管理されたデプロイを作成してからコードを変更すると、ヘッド デプロイには変更が反映されますが、バージョン管理されたデプロイはそのまま残ります。
ヘッドデプロイを使用してコードをテストします。一般公開用のヘッドデプロイは使用しないでください。
バージョン管理されたデプロイ
バージョン管理されたデプロイでは、特定のバージョンのプロジェクト コードを使用できます。これにより、ユーザーは機能するバージョンを使い続けながら、コードの変更や改善を行うことができます。
アプリケーションを公開して使用する場合は、常にバージョン付きのデプロイを使用します。一度に複数のアクティブなバージョン付きデプロイを作成できます。
重要: バージョン管理されたデプロイの所有権を譲渡することはできません。スクリプト プロジェクトのオーナー権限を他のユーザーに譲渡しても、プロジェクト内の既存のバージョン付きデプロイのオーナーは変更されません。管理者がデプロイ オーナーのアカウントを削除すると、デプロイでスクリプト エラーが発生することがあります。
バージョン管理されたデプロイを作成する
Google Workspace アドオン、エディタ用アドオン、Google Chat 用アプリ、API 実行可能ファイルのバージョンをデプロイするには、まず Apps Script の Google Cloud プロジェクトの関連付けをデフォルト プロジェクトから標準プロジェクトに切り替える必要があります。
バージョン管理されたデプロイを作成する手順は次のとおりです。
- Apps Script プロジェクトを開きます。
- 右上にある [デプロイ] > [新しいデプロイ] をクリックします。
- [種類の選択] の隣にある [デプロイタイプを有効にする] をクリックします。
- デプロイするデプロイタイプを選択します。Google Workspace アドオン、Editor アドオン、Google Chat アプリの場合は、[アドオン] を選択します。
デプロイに関する情報を入力し、[デプロイ] をクリックします。
バージョン管理されたデプロイを表示する
Apps Script プロジェクトのデプロイを表示するには、上部の [デプロイ] > [デプロイを管理] をクリックします。
特定のバージョンのコードを表示するには、以前のバージョンを表示するをご覧ください。
バージョン管理されたデプロイを編集する
バージョン管理されたデプロイを編集して、説明やバージョンを変更できます。デプロイを編集する手順は次のとおりです。
- Apps Script プロジェクトを開きます。
- [Deploy] > [Manage deployments] をクリックします。
- 変更するアクティブなデプロイを選択し、編集アイコン をクリックします。
変更を加えて、[デプロイ] をクリックします。
アーカイブされたデプロイを編集する場合は、再デプロイしてから上記の手順を行います。
プロジェクト コードに変更をデプロイする場合は、新しいバージョンを作成して、それを使用するようにデプロイを編集します。新しいバージョンは、そのデプロイを使用するすべてのユーザーによって自動的に使用されます。
デプロイ ID を確認する
デプロイごとに、関連付けられた文字列 ID が自動的に作成されます。この ID を確認する手順は次のとおりです。
- Apps Script プロジェクトを開きます。
- 右上にある [デプロイ] > [デプロイを管理] をクリックします。
アクティブなデプロイを選択して ID を確認します。
デプロイ ID は、アクティブなデプロイにのみ表示されます。
デプロイをテストする
デプロイのテスト方法は、ビルドするアプリの種類によって異なります。
Google Workspace アドオン
Google Workspace アドオンのデプロイをテストするには、 Google Workspace アドオンのテストをご覧ください。
エディタ アドオン
エディタ用アドオンのデプロイをテストするには、エディタ用アドオンをテストするをご覧ください。
ウェブアプリ
ウェブアプリのデプロイをテストするには、 ウェブアプリのデプロイをテストするをご覧ください。
Google Chat アプリ
Chat 用アプリのデプロイをテストするには、まずスクリプトの バージョン付きデプロイを作成して、デプロイ ID にアクセスする必要があります。
デプロイ ID を取得したら、Chat API 構成で ID を指定し、インタラクティブ機能をテストする手順に沿って操作します。
API 実行可能ファイル
API 実行可能ファイルのデプロイをテストするには、まず バージョン管理されたデプロイを作成する必要があります。デプロイを作成したら、次の手順を行います。
- Apps Script プロジェクトの右上にある [デプロイ] > [デプロイをテスト] をクリックします。
- [種類の選択] の横にある [デプロイタイプを有効にする]
> [API 実行可能ファイル] をクリックします。
- URL をコピーして、API 実行可能ファイルのデプロイをテストします。
バージョン付きデプロイをアーカイブする
バージョン管理されたデプロイは削除できません。代わりに、アーカイブできます。
バージョン管理されたデプロイをアーカイブするには:
- Apps Script プロジェクトを開きます。
- [Deploy] > [Manage deployments] をクリックします。
- アーカイブするデプロイを選択し、[デプロイをアーカイブ] をクリックします。
アーカイブされたデプロイを再デプロイする
- Apps Script プロジェクトを開きます。
- 右上にある [デプロイ] > [デプロイを管理] をクリックします。
- 左側の [アーカイブ済み] で、再デプロイするデプロイを選択し、[編集] > [デプロイ] をクリックします。