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